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/v15/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 ID de las marcas que ya seleccionaron los anunciantes. Se excluirán como 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 marca 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 de 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 de CKG para las marcas verificadas o con alcance global.
name

string

Es el nombre de la marca.
urls[]

string

Son las URLs que identifican la marca de manera única.
state

enum (BrandState)

Es el estado actual de la marca.

BrandState

Es una enumeración de los diferentes estados de la marca.

Enumeradores
UNSPECIFIED No se especificó ningún valor.
UNKNOWN Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
ENABLED La marca está verificada y disponible en todo el mundo para su selección
DEPRECATED La marca estaba disponible a nivel mundial en el pasado, pero ya no es una marca válida (según los criterios comerciales).
UNVERIFIED La marca no está verificada y se centra en el cliente, pero el cliente (solo quien solicitó lo mismo) puede seleccionarla para la segmentación
APPROVED Se trata de una marca centrada en el cliente (no verificada), que obtuvo la aprobación de la empresa y se agregó a la lista global. Se debe usar su MID de CKG asignado en lugar de este
CANCELLED Era una marca centrada en el cliente (no verificada), pero el cliente canceló la solicitud y este ID de marca ya no es válido
REJECTED Era una marca centrada en el cliente (no verificada), pero el equipo empresarial interno rechazó la solicitud, por lo que este ID de marca ya no es válido