Method: customers.generateKeywordHistoricalMetrics

Возвращает список исторических показателей ключевых слов.

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

HTTP-запрос

POST https://googleads.googleapis.com/v18/customers/{customerId}:generateKeywordHistoricalMetrics

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

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

Параметры
customer Id

string

Идентификатор клиента с рекомендацией.

Тело запроса

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

JSON-представление 
{
  "keywords": [
    string
  ],
  "includeAdultKeywords": boolean,
  "geoTargetConstants": [
    string
  ],
  "keywordPlanNetwork": enum (KeywordPlanNetwork),
  "aggregateMetrics": {
    object (KeywordPlanAggregateMetrics)
  },
  "historicalMetricsOptions": {
    object (HistoricalMetricsOptions)
  },
  "language": string
}
Поля
keywords[]

string

Список ключевых слов для получения исторических показателей. Не все входные данные будут возвращены в результате почти точной дедупликации. Например, если запрошена статистика для «автомобиль» и «автомобили», будет возвращено только «автомобиль». Можно использовать максимум 10 000 ключевых слов.

include Adult Keywords

boolean

Если это правда, в ответ будут включены ключевые слова для взрослых. Значение по умолчанию — ложь.

geo Target Constants[]

string

Имена ресурсов целевого местоположения. Максимум — 10. Пустой список МОЖЕТ использоваться для указания всех географических регионов таргетинга.

keyword Plan Network

enum ( KeywordPlanNetwork )

Таргетинговая сеть. Если этот параметр не установлен, будет использоваться поисковая и партнерская сеть Google.

aggregate Metrics

object ( KeywordPlanAggregateMetrics )

Агрегатные поля, которые необходимо включить в ответ.

historical Metrics Options

object ( HistoricalMetricsOptions )

Параметры исторических данных метрик.

language

string

Имя ресурса целевого языка. Каждое ключевое слово принадлежит некоторому набору языков; ключевое слово включается, если язык является одним из его языков. Если не установлено, будут включены все ключевые слова.

Тело ответа

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

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

JSON-представление 
{
  "results": [
    {
      object (GenerateKeywordHistoricalMetricsResult)
    }
  ],
  "aggregateMetricResults": {
    object (KeywordPlanAggregateMetricResults)
  }
}
Поля
results[]

object ( GenerateKeywordHistoricalMetricsResult )

Список ключевых слов и их исторические показатели.

aggregate Metric Results

object ( KeywordPlanAggregateMetricResults )

Совокупные показатели для всех ключевых слов.

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

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

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

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

Создать ключевое словоHistoricalMetricsResult

Результат создания исторических показателей ключевых слов.

JSON-представление 
{
  "closeVariants": [
    string
  ],
  "keywordMetrics": {
    object (KeywordPlanHistoricalMetrics)
  },
  "text": string
}
Поля
close Variants[]

string

Список близких вариантов запрошенных ключевых слов, статистика которых объединяется в этот GenerateKeywordHistoricalMetricsResult.

keyword Metrics

object ( KeywordPlanHistoricalMetrics )

Исторические метрики для текста и его близких вариантов

text

string

Текст запроса, связанный с одним или несколькими ключевыми словами. Обратите внимание, что мы устраняем дублирование вашего списка ключевых слов, исключая близкие варианты, прежде чем возвращать ключевые слова в виде текста. Например, если ваш запрос изначально содержал ключевые слова «автомобиль» и «автомобили», возвращаемый поисковый запрос будет содержать только «автомобили». Список дедуплицированных запросов будет включен в поле closeVariants.