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/v16/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 senza costi. Se le dimensioni richieste includono Attributi CATEGORY o KNOWLEDGE_GRAPH, gli attributi restituiti per quelle dimensioni corrisponderanno o saranno correlati a questa stringa. Per le altre dimensioni, questo campo viene ignorato e vengono restituiti tutti gli attributi disponibili.
customerInsightsGroup

string

Il nome del cliente per il quale stai eseguendo 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 che corrispondono alla query di ricerca.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.