Method: customers.suggestBrands

RPC pour renvoyer une liste de marques correspondantes en fonction d'un préfixe pour ce client.

Requête HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}:suggestBrands

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Obligatoire. ID du client auquel appliquer l'opération de suggestion de marque.

Corps de la requête

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

Représentation JSON 
{
  "selectedBrands": [
    string
  ],
  "brandPrefix": string
}
Champs
selectedBrands[]

string

Facultatif. Identifiants des marques déjà sélectionnées par les annonceurs. Elles seront alors exclues. Il doit s'agir d'identifiants de marque, et non de noms de marques.
brandPrefix

string

Obligatoire. Préfixe d'un nom de marque.

Corps de la réponse

Message de réponse pour BrandSuggestionService.SuggestBrands.

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

Représentation JSON 
{
  "brands": [
    {
      object (BrandSuggestion)
    }
  ]
}
Champs
brands[]

object (BrandSuggestion)

Suggestions générées de marques validées pour le préfixe donné.

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.

BrandSuggestion

Informations sur la suggestion de marque.

Représentation JSON 
{
  "id": string,
  "name": string,
  "urls": [
    string
  ],
  "state": enum (BrandState)
}
Champs
id

string

ID de la marque. Il s'agit de CKG MID pour les marques validées ou dont la portée est internationale.
name

string

Nom de la marque.
urls[]

string

URL permettant d'identifier la marque de manière unique.
state

enum (BrandState)

État actuel de la marque.