Method: customers.generateAdGroupThemes

Возвращает список предлагаемых групп объявлений и предлагаемых модификаций (текст, тип соответствия) для заданных ключевых слов.

Список выброшенных ошибок: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError

HTTP-запрос

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

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

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

Параметры
customer Id

string

Необходимый. Идентификатор клиента.

Тело запроса

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

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

string

Необходимый. Список ключевых слов для группировки в предоставленные группы объявлений.

ad Groups[]

string

Необходимый. Список названий ресурсов групп объявлений, в которые можно сгруппировать ключевые слова. Формат имени ресурса: customers/{customerId}/adGroups/{adGroupId}

Тело ответа

Ответное сообщение для KeywordPlanIdeaService.GenerateAdGroupThemes .

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

JSON-представление 
{
  "adGroupKeywordSuggestions": [
    {
      object (AdGroupKeywordSuggestion)
    }
  ],
  "unusableAdGroups": [
    {
      object (UnusableAdGroup)
    }
  ]
}
Поля
ad Group Keyword Suggestions[]

object ( AdGroupKeywordSuggestion )

Список предлагаемых сочетаний группы объявлений и ключевых слов.

unusable Ad Groups[]

object ( UnusableAdGroup )

Список предоставленных групп объявлений, которые нельзя использовать в качестве предложений.

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

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

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

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

Группа объявленийКлючевое словоПредложение

Предлагаемый текст и сочетание группы объявлений и кампании для данного ключевого слова.

JSON-представление 
{
  "keywordText": string,
  "suggestedKeywordText": string,
  "suggestedMatchType": enum (KeywordMatchType),
  "suggestedAdGroup": string,
  "suggestedCampaign": string
}
Поля
keyword Text

string

Исходный текст ключевого слова.

suggested Keyword Text

string

Нормализованная версия ключевого слова Text для предложений BROAD/EXACT/PHRASE.

suggested Match Type

enum ( KeywordMatchType )

Предлагаемый тип соответствия ключевого слова.

suggested Ad Group

string

Предлагаемая группа объявлений для ключевого слова. Формат имени ресурса: customers/{customerId}/adGroups/{adGroupId}

suggested Campaign

string

Предлагаемая кампания для ключевого слова. Формат имени ресурса: customers/{customerId}/campaigns/{campaignId}

Неиспользуемая группа объявлений

Пара «Группа объявлений/Кампания», которую нельзя использовать в качестве предложения по ключевым словам.

Группы объявлений могут быть недоступны для использования, если группа объявлений

  • принадлежит кампании, которая не ВКЛЮЧЕНА и НЕ ПРИОСТАНОВЛЕНА
  • сам по себе НЕ ВКЛЮЧЕН
JSON-представление 
{
  "adGroup": string,
  "campaign": string
}
Поля
ad Group

string

Имя ресурса AdGroup. Формат имени ресурса: customers/{customerId}/adGroups/{adGroupId}

campaign

string

Имя ресурса кампании. Формат имени ресурса: customers/{customerId}/campaigns/{campaignId}