- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- Группа объявленийКлючевое словоПредложение
- Неиспользуемая группа объявлений
- Попробуйте!
Возвращает список предлагаемых групп объявлений и предлагаемых модификаций (текст, тип соответствия) для заданных ключевых слов.
Список выброшенных ошибок: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError
HTTP-запрос
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateAdGroupThemes
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
customerId | Необходимый. Идентификатор клиента. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "keywords": [ string ], "adGroups": [ string ] } |
Поля | |
---|---|
keywords[] | Необходимый. Список ключевых слов для группировки в предоставленные группы объявлений. |
adGroups[] | Необходимый. Список названий ресурсов групп объявлений, в которые можно сгруппировать ключевые слова. Формат имени ресурса: |
Тело ответа
Ответное сообщение для KeywordPlanIdeaService.GenerateAdGroupThemes
.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{ "adGroupKeywordSuggestions": [ { object ( |
Поля | |
---|---|
adGroupKeywordSuggestions[] | Список предлагаемых сочетаний группы объявлений и ключевых слов. |
unusableAdGroups[] | Список предоставленных групп объявлений, которые нельзя использовать в качестве предложений. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/adwords
Дополнительную информацию см. в обзоре OAuth 2.0 .
Группа объявленийКлючевое словоПредложение
Предлагаемый текст и сочетание группы объявлений и кампании для данного ключевого слова.
JSON-представление |
---|
{
"keywordText": string,
"suggestedKeywordText": string,
"suggestedMatchType": enum ( |
Поля | |
---|---|
keywordText | Исходный текст ключевого слова. |
suggestedKeywordText | Нормализованная версия ключевого словаText для предложений BROAD/EXACT/PHRASE. |
suggestedMatchType | Предлагаемый тип соответствия ключевого слова. |
suggestedAdGroup | Предлагаемая группа объявлений для ключевого слова. Формат имени ресурса: |
suggestedCampaign | Предлагаемая кампания для ключевого слова. Формат имени ресурса: |
Неиспользуемая группа объявлений
Пара «Группа объявлений/Кампания», которую нельзя использовать в качестве предложения по ключевым словам.
Группы объявлений могут быть недоступны для использования, если группа объявлений
- принадлежит кампании, которая не ВКЛЮЧЕНА и НЕ ПРИОСТАНОВЛЕНА
- сам по себе НЕ ВКЛЮЧЕН
JSON-представление |
---|
{ "adGroup": string, "campaign": string } |
Поля | |
---|---|
adGroup | Имя ресурса AdGroup. Формат имени ресурса: |
campaign | Имя ресурса кампании. Формат имени ресурса: |