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/v16/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 exclues en réponse. Il s'agit généralement 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)

Des suggestions de marques ont été généré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

Identifiant de la marque. Il s'agit du MID CKG pour les marques validées ou mondiales.
name

string

Nom de la marque.
urls[]

string

URL permettant d'identifier la marque de façon unique.
state

enum (BrandState)

État actuel de la marque.