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/v16/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 ya seleccionadas por los anunciantes. Se excluirán en respuesta. Se espera que sean IDs de marcas, no nombres de marcas.
brandPrefix

string

Obligatorio. Es 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 verificadas para el prefijo dado.

Permisos 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 sobre 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 el MID del CKG para las 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