Method: customers.suggestBrands

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

HTTP-запрос

POST https://googleads.googleapis.com/v15/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 )

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

БрэндСтат

Перечисление различных состояний бренда.

Перечисления
UNSPECIFIED Значение не указано.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
ENABLED Бренд проверен и доступен для выбора по всему миру.
DEPRECATED В прошлом бренд был доступен во всем мире, но больше не является действительным брендом (на основе бизнес-критериев)
UNVERIFIED Бренд не проверен и ограничен клиентом, но может быть выбран клиентом (только тот, кто запросил его) для таргетинга.
APPROVED Был брендом, ориентированным на клиентов (непроверенным), который был одобрен бизнесом и добавлен в глобальный список. Вместо этого следует использовать присвоенный ему CKG MID.
CANCELLED Был брендом на уровне клиента (неподтвержденным), но запрос был отменен клиентом, и этот идентификатор бренда больше не действителен.
REJECTED Был брендом на уровне клиента (непроверенным), но запрос был отклонен внутренней бизнес-группой, и этот идентификатор бренда больше не действителен.