Method: customers.suggestBrands

Rpc для возврата списка соответствующих брендов на основе префикса для этого клиента.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
customerId

string

Необходимый. Идентификатор клиента, к которому следует применить операцию предложения бренда.

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление
{
  "selectedBrands": [
    string
  ],
  "brandPrefix": string
}
Поля
selectedBrands[]

string

Необязательный. Идентификаторы уже выбранных рекламодателями брендов. В ответ они будут исключены. Ожидается, что это будут идентификаторы брендов, а не названия брендов.

brandPrefix

string

Необходимый. Префикс названия бренда.

Тело ответа

Ответное сообщение для BrandSuggestionService.SuggestBrands .

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "brands": [
    {
      object (BrandSuggestion)
    }
  ]
}
Поля
brands[]

object ( BrandSuggestion )

Сгенерированы предложения проверенных брендов для данного префикса.

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .

БрендПредложение

Информация о предложении бренда.

JSON-представление
{
  "id": string,
  "name": string,
  "urls": [
    string
  ],
  "state": enum (BrandState)
}
Поля
id

string

Идентификатор бренда. Для проверенных/глобальных брендов это будет CKG MID.

name

string

Название бренда.

urls[]

string

URL-адреса, которые однозначно идентифицируют бренд.

state

enum ( BrandState )

Текущее состояние бренда.