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/v15/customers/{customerId}:suggestBrands

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

Obligatoire. Identifiant 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. Ils seront exclus de la réponse. Il doit s'agir d'ID 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 liées à 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 de l'ID MID CKG pour les marques validées/à l'échelle mondiale.
name

string

Nom de la marque.
urls[]

string

URL qui identifient la marque de façon unique.
state

enum (BrandState)

État actuel de la marque.

BrandState

Énumération des différents états de la marque.

Enums
UNSPECIFIED Aucune valeur n'a été spécifiée.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ENABLED La marque est validée et peut être sélectionnée dans le monde entier
DEPRECATED La marque était auparavant disponible dans le monde entier, mais elle n'est plus valide (d'après des critères commerciaux)
UNVERIFIED La marque n'est pas validée et est définie au niveau du client, mais elle peut être sélectionnée par le client (seulement qui en a fait la demande) à des fins de ciblage.
APPROVED Il s'agit d'une marque dont la portée est définie au niveau du client (non validée), qui a été approuvée par l'entreprise et ajoutée à la liste globale. Le MID CKG qui lui est attribué doit être utilisé à la place
CANCELLED La marque était définie au niveau du client (non validée), mais la demande a été annulée par le client et cet ID de marque n'est plus valide
REJECTED Il s'agissait d'une marque au niveau du client (non validée), mais la requête a été refusée par l'équipe commerciale interne et cet ID de marque n'est plus valide.