Method: customers.searchAudienceInsightsAttributes

Recherche des attributs d'audience qui peuvent être utilisés pour générer des insights.

Liste des erreurs générées: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Obligatoire. ID du client.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "queryText": string,
  "customerInsightsGroup": string,
  "locationCountryFilters": [
    {
      object (LocationInfo)
    }
  ]
}
Champs
dimensions[]

enum (AudienceInsightsDimension)

Obligatoire. Types d'attributs à renvoyer.

queryText

string

Obligatoire. Requête en texte libre. Si les dimensions demandées incluent les attributs CATEGORY ou KNOWLEDGE_GRAPH, les attributs renvoyés pour ces dimensions correspondront ou seront liés à cette chaîne. Pour les autres dimensions, ce champ est ignoré, et tous les attributs disponibles sont renvoyés.

customerInsightsGroup

string

Nom du client pour lequel effectuer la planification. Cette valeur est définie par l'utilisateur.

locationCountryFilters[]

object (LocationInfo)

Si les attributs SUB_COUNTRY_LOCATION font partie des dimensions demandées et que ce champ est présent, les attributs SUB_COUNTRY_LOCATION renvoyés seront situés dans ces pays. Si ce champ est absent, les attributs de lieu ne sont pas filtrés par pays. Si vous définissez ce champ lorsque les attributs SUB_COUNTRY_LOCATION ne sont pas demandés, une erreur est renvoyée.

Corps de la réponse

Message de réponse pour AudienceInsightsService.ListAudienceInsightsAttributes.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "attributes": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ]
}
Champs
attributes[]

object (AudienceInsightsAttributeMetadata)

Les attributs correspondant à la requête de recherche

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la présentation d'OAuth 2.0.