Method: customers.generateInsightsFinderReport

Создает сохраненный отчет, который можно просмотреть в инструменте Insights Finder.

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

HTTP-запрос

POST https://googleads.googleapis.com/v14/customers/{customerId}:generateInsightsFinderReport

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

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

Параметры
customerId

string

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

Тело запроса

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

JSON-представление
{
  "baselineAudience": {
    object (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
Поля
baselineAudience

object ( BasicInsightsAudience )

Необходимый. Базовая аудитория для этого отчета: обычно все люди в регионе.

specificAudience

object ( BasicInsightsAudience )

Необходимый. Конкретная аудитория, представляющая интерес для этого отчета. Информация в отчете будет основана на атрибутах, более распространенных в этой аудитории, чем в базовой аудитории отчета.

customerInsightsGroup

string

Имя планируемого клиента. Это определяемое пользователем значение.

Тело ответа

Ответное сообщение для AudienceInsightsService.GenerateInsightsFinderReport , содержащее общий URL-адрес отчета.

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

JSON-представление
{
  "savedReportUrl": string
}
Поля
savedReportUrl

string

URL-адрес HTTPS, обеспечивающий глубокую ссылку на пользовательский интерфейс Insights Finder с входными данными отчета, заполненными в соответствии с запросом.

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

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

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

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

BasicInsightsАудитория

Описание аудитории, используемой для запроса статистики.

JSON-представление
{
  "countryLocation": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "userInterests": [
    {
      object (UserInterestInfo)
    }
  ],
  "topics": [
    {
      object (AudienceInsightsTopic)
    }
  ]
}
Поля
countryLocation[]

object ( LocationInfo )

Необходимый. Страны для этой аудитории.

subCountryLocations[]

object ( LocationInfo )

Атрибуты географического положения подстраны. Если они присутствуют, каждый из них должен содержаться в одной из стран этой аудитории.

gender

object ( GenderInfo )

Пол для аудитории. При его отсутствии аудитория не ограничивается по полу.

ageRanges[]

object ( AgeRangeInfo )

Возрастные диапазоны аудитории. Если он отсутствует, аудитория представляет всех людей старше 18 лет, соответствующих другим атрибутам.

userInterests[]

object ( UserInterestInfo )

Интересы пользователей, определяющие эту аудиторию. Поддерживаются аудитории по интересам и заинтересованных покупателей.

topics[]

object ( AudienceInsightsTopic )

Темы, представленные объектами сети знаний и/или категориями продуктов и услуг, которые интересуют эту аудиторию.

АудиторияInsightsТема

Сущность или категория, представляющая тему, определяющую аудиторию.

JSON-представление
{

  // Union field topic can be only one of the following:
  "entity": {
    object (AudienceInsightsEntity)
  },
  "category": {
    object (AudienceInsightsCategory)
  }
  // End of list of possible types for union field topic.
}
Поля
topic поля Союза. Атрибут сущности или категории. topic может быть только одной из следующих:
entity

object ( AudienceInsightsEntity )

Объект «График знаний»

category

object ( AudienceInsightsCategory )

Категория продуктов и услуг