Method: customers.searchAudienceInsightsAttributes

Cerca attributi dei segmenti di pubblico che possono essere utilizzati per generare approfondimenti.

Elenco degli errori generati: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

Richiesta HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:searchAudienceInsightsAttributes

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

Obbligatorio. L'ID del cliente.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "queryText": string,
  "customerInsightsGroup": string,
  "locationCountryFilters": [
    {
      object (LocationInfo)
    }
  ]
}
Campi
dimensions[]

enum (AudienceInsightsDimension)

Obbligatorio. I tipi di attributi da restituire.
queryText

string

Obbligatorio. Una query di testo libero. Se le dimensioni richieste includono Attributi CATEGORY o KNOWLEDGE_GRAPH, gli attributi restituiti per quelle dimensioni corrisponderanno o saranno correlati alla stringa. Per le altre dimensioni, questo campo viene ignorato e vengono restituiti tutti gli attributi disponibili.
customerInsightsGroup

string

Il nome del cliente per cui è stata pianificata la pianificazione. Questo è un valore definito dall'utente.
locationCountryFilters[]

object (LocationInfo)

Se gli attributi SUB_COUNTRY_LOCATION sono una delle dimensioni richieste e questo campo è presente, gli attributi SUB_COUNTRY_LOCATION restituiti si troveranno in questi paesi. Se questo campo non è presente, gli attributi relativi alla località non vengono filtrati in base al paese. Se imposti questo campo quando gli attributi SUB_COUNTRY_LOCATION non vengono richiesti, verrà restituito un errore.

Corpo della risposta

Messaggio di risposta per AudienceInsightsService.ListAudienceInsightsAttributes.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "attributes": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ]
}
Campi
attributes[]

object (AudienceInsightsAttributeMetadata)

Gli attributi corrispondenti alla query di ricerca.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/adwords

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.