Method: customers.suggestBrands

Rpc para mostrar una lista de marcas coincidentes en función de un prefijo para este cliente

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customerId

string

Obligatorio. El ID del cliente al que se aplicará la operación de sugerencia de marca.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "selectedBrands": [
    string
  ],
  "brandPrefix": string
}
Campos
selectedBrands[]

string

Opcional. Son los IDs de las marcas que los anunciantes ya seleccionaron. Se excluirá como respuesta. Se espera que sean IDs de marca, no nombres de marca.
brandPrefix

string

Obligatorio. El prefijo del nombre de una marca.

Cuerpo de la respuesta

Mensaje de respuesta para BrandSuggestionService.SuggestBrands.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "brands": [
    {
      object (BrandSuggestion)
    }
  ]
}
Campos
brands[]

object (BrandSuggestion)

Se generaron sugerencias de marcas de marcas verificadas para el prefijo especificado.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la descripción general de OAuth 2.0.

BrandSuggestion

Información de la sugerencia de marca.

Representación JSON 
{
  "id": string,
  "name": string,
  "urls": [
    string
  ],
  "state": enum (BrandState)
}
Campos
id

string

Es el ID de la marca. Sería CKG MID para marcas verificadas o con alcance global.
name

string

Es el nombre de la marca.
urls[]

string

Son las URLs que identifican de manera inequívoca la marca.
state

enum (BrandState)

Estado actual de la marca.