- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- BasicInsightsАудитория
- АудиторияInsightsТема
- Попробуй это!
Создает сохраненный отчет, который можно просмотреть в инструменте Insights Finder.
Список выброшенных ошибок: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
HTTP-запрос
POST https://googleads.googleapis.com/v15/customers/{customerId}:generateInsightsFinderReport
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
customerId | Необходимый. Идентификатор клиента. |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "baselineAudience": { object ( |
Поля | |
---|---|
baselineAudience | Необходимый. Базовая аудитория для этого отчета: обычно все люди в регионе. |
specificAudience | Необходимый. Конкретная аудитория, представляющая интерес для этого отчета. Информация в отчете будет основана на атрибутах, более распространенных в этой аудитории, чем в базовой аудитории отчета. |
customerInsightsGroup | Имя планируемого клиента. Это определяемое пользователем значение. |
Тело ответа
Ответное сообщение для AudienceInsightsService.GenerateInsightsFinderReport
, содержащее общий URL-адрес отчета.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{ "savedReportUrl": string } |
Поля | |
---|---|
savedReportUrl | URL-адрес HTTPS, обеспечивающий глубокую ссылку на пользовательский интерфейс Insights Finder с входными данными отчета, заполненными в соответствии с запросом. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/adwords
Дополнительную информацию см. в обзоре OAuth 2.0 .
BasicInsightsАудитория
Описание аудитории, используемой для запроса статистики.
JSON-представление |
---|
{ "countryLocation": [ { object ( |
Поля | |
---|---|
countryLocation[] | Необходимый. Страны для этой аудитории. |
subCountryLocations[] | Атрибуты географического положения подстраны. Если они присутствуют, каждый из них должен содержаться в одной из стран этой аудитории. |
gender | Пол для аудитории. При его отсутствии аудитория не ограничивается по полу. |
ageRanges[] | Возрастные диапазоны аудитории. Если он отсутствует, аудитория представляет всех людей старше 18 лет, соответствующих другим атрибутам. |
userInterests[] | Интересы пользователей, определяющие эту аудиторию. Поддерживаются аудитории по интересам и заинтересованных покупателей. |
topics[] | Темы, представленные объектами сети знаний и/или категориями продуктов и услуг, которые интересуют эту аудиторию. |
АудиторияInsightsТема
Сущность или категория, представляющая тему, определяющую аудиторию.
JSON-представление |
---|
{ // Union field |
Поля | |
---|---|
topic поля Союза. Атрибут сущности или категории. topic может быть только одной из следующих: | |
entity | Объект «График знаний» |
category | Категория продуктов и услуг |