- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- БрендПредложение
- БрэндСтат
- Попробуй это!
Rpc для возврата списка соответствующих брендов на основе префикса для этого клиента.
HTTP-запрос
POST https://googleads.googleapis.com/v15/customers/{customerId}:suggestBrands
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
customerId | Необходимый. Идентификатор клиента, к которому следует применить операцию предложения бренда. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "selectedBrands": [ string ], "brandPrefix": string } |
Поля | |
---|---|
selectedBrands[] | Необязательный. Идентификаторы уже выбранных рекламодателями брендов. В ответ они будут исключены. Ожидается, что это будут идентификаторы брендов, а не названия брендов. |
brandPrefix | Необходимый. Префикс названия бренда. |
Тело ответа
Ответное сообщение для BrandSuggestionService.SuggestBrands
.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"brands": [
{
object ( |
Поля | |
---|---|
brands[] | Сгенерированы предложения проверенных брендов для данного префикса. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/adwords
Дополнительную информацию см. в обзоре OAuth 2.0 .
БрендПредложение
Информация о предложении бренда.
JSON-представление |
---|
{
"id": string,
"name": string,
"urls": [
string
],
"state": enum ( |
Поля | |
---|---|
id | Идентификатор бренда. Для проверенных/глобальных брендов это будет CKG MID. |
name | Название бренда. |
urls[] | URL-адреса, которые однозначно идентифицируют бренд. |
state | Текущее состояние бренда. |
БрэндСтат
Перечисление различных состояний бренда.
Перечисления | |
---|---|
UNSPECIFIED | Значение не указано. |
UNKNOWN | Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии. |
ENABLED | Бренд проверен и доступен для выбора по всему миру. |
DEPRECATED | В прошлом бренд был доступен во всем мире, но больше не является действительным брендом (на основе бизнес-критериев) |
UNVERIFIED | Бренд не проверен и ограничен клиентом, но может быть выбран клиентом (только тот, кто запросил его) для таргетинга. |
APPROVED | Был брендом, ориентированным на клиентов (непроверенным), который был одобрен бизнесом и добавлен в глобальный список. Вместо этого следует использовать присвоенный ему CKG MID. |
CANCELLED | Был брендом на уровне клиента (неподтвержденным), но запрос был отменен клиентом, и этот идентификатор бренда больше не действителен. |
REJECTED | Был брендом на уровне клиента (непроверенным), но запрос был отклонен внутренней бизнес-группой, и этот идентификатор бренда больше не действителен. |