Method: properties.audienceExports.query

Получает экспорт аудитории пользователей. После создания аудитории пользователи не сразу доступны для экспорта. Во-первых, запрос к audienceExports.create необходим для создания экспорта пользователей аудитории, а затем, во-вторых, этот метод используется для извлечения пользователей из экспорта аудитории.

См. раздел «Создание экспорта аудитории» для ознакомления с экспортом аудиторий с примерами.

Аудитории в Google Analytics 4 позволяют сегментировать пользователей по критериям, важным для вашего бизнеса. Дополнительную информацию см. на странице https://support.google.com/analytics/answer/9267572 .

API экспорта аудитории имеют некоторые методы в альфа-версии и другие методы в бета-версии. Цель состоит в том, чтобы усовершенствовать методы обеспечения бета-стабильности после получения отзывов и принятия. Чтобы оставить отзыв об этом API, заполните форму отзыва об API экспорта аудитории Google Analytics .

HTTP-запрос

POST https://analyticsdata.googleapis.com/v1beta/{name=properties/*/audienceExports/*}:query

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

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

Параметры
name

string

Необходимый. Имя экспортируемой аудитории, из которой извлекаются пользователи. Формат: properties/{property}/audienceExports/{audienceExport}

Тело запроса

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

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

string ( int64 format)

Необязательный. Количество строк в начальной строке. Первая строка считается строкой 0.

При пейджинге первый запрос не указывает смещение; или, что то же самое, устанавливает смещение в 0; первый запрос возвращает первый limit строк. Второй запрос устанавливает смещение, равное limit первого запроса; второй запрос возвращает второй limit строк.

Дополнительные сведения об этом параметре нумерации страниц см. в разделе Нумерация страниц .

limit

string ( int64 format)

Необязательный. Количество возвращаемых строк. Если не указано, возвращается 10 000 строк. API возвращает максимум 250 000 строк на запрос, независимо от того, сколько вы запрашиваете. limit должен быть положительным.

API также может возвращать меньше строк, чем запрошенное limit , если значений измерения не так много, как limit .

Дополнительные сведения об этом параметре нумерации страниц см. в разделе Нумерация страниц .

Тело ответа

Список пользователей в экспорте аудитории.

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

JSON-представление 
{
  "audienceRows": [
    {
      object (AudienceRow)
    }
  ],
  "audienceExport": {
    object (AudienceExport)
  },
  "rowCount": integer
}
Поля
audience Rows[]

object ( AudienceRow )

Строки для каждого пользователя в экспорте аудитории. Количество строк в этом ответе будет меньше или равно размеру страницы запроса.

audience Export

object ( AudienceExport )

Данные конфигурации о запрашиваемом AudienceExport. Вернулся, чтобы помочь интерпретировать строки аудитории в этом ответе. Например, размеры в этом AudienceExport соответствуют столбцам в AudienceRows.

row Count

integer

Общее количество строк в результате AudienceExport. rowCount не зависит от количества строк, возвращаемых в ответе, параметра запроса limit и параметра запроса offset . Например, если запрос возвращает 175 строк и включает limit в 50 в запросе API, ответ будет содержать rowCount равный 175, но только 50 строк.

Дополнительные сведения об этом параметре нумерации страниц см. в разделе Нумерация страниц .

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

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

AudienceRow

Атрибуты значений измерения для строки пользователя аудитории.

JSON-представление 
{
  "dimensionValues": [
    {
      object (AudienceDimensionValue)
    }
  ]
}
Поля
dimension Values[]

object ( AudienceDimensionValue )

Каждый атрибут значения измерения для пользователя аудитории. Одно значение измерения будет добавлено для каждого запрошенного столбца измерения.

АудиторияИзмерениеЗначение

Значение измерения.

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

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
Поля
Поле объединения one_value . Один из видов размерных значений. one_value может быть только одним из следующих:
value

string

Значение в виде строки, если тип измерения является строкой.

,

Получает экспорт аудитории пользователей. После создания аудитории пользователи не сразу доступны для экспорта. Во-первых, запрос к audienceExports.create необходим для создания экспорта пользователей аудитории, а затем, во-вторых, этот метод используется для извлечения пользователей из экспорта аудитории.

См. раздел «Создание экспорта аудитории» для ознакомления с экспортом аудиторий с примерами.

Аудитории в Google Analytics 4 позволяют сегментировать пользователей по критериям, важным для вашего бизнеса. Дополнительную информацию см. на странице https://support.google.com/analytics/answer/9267572 .

API экспорта аудитории имеют некоторые методы в альфа-версии и другие методы в бета-версии. Цель состоит в том, чтобы усовершенствовать методы обеспечения бета-стабильности после получения отзывов и принятия. Чтобы оставить отзыв об этом API, заполните форму отзыва об API экспорта аудитории Google Analytics .

HTTP-запрос

POST https://analyticsdata.googleapis.com/v1beta/{name=properties/*/audienceExports/*}:query

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

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

Параметры
name

string

Необходимый. Имя экспортируемой аудитории, из которой извлекаются пользователи. Формат: properties/{property}/audienceExports/{audienceExport}

Тело запроса

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

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

string ( int64 format)

Необязательный. Количество строк в начальной строке. Первая строка считается строкой 0.

При пейджинге первый запрос не указывает смещение; или, что то же самое, устанавливает смещение в 0; первый запрос возвращает первый limit строк. Второй запрос устанавливает смещение, равное limit первого запроса; второй запрос возвращает второй limit строк.

Дополнительные сведения об этом параметре нумерации страниц см. в разделе Нумерация страниц .

limit

string ( int64 format)

Необязательный. Количество возвращаемых строк. Если не указано, возвращается 10 000 строк. API возвращает максимум 250 000 строк на запрос, независимо от того, сколько вы запрашиваете. limit должен быть положительным.

API также может возвращать меньше строк, чем запрошенное limit , если значений измерения не так много, как limit .

Дополнительные сведения об этом параметре нумерации страниц см. в разделе Нумерация страниц .

Тело ответа

Список пользователей в экспорте аудитории.

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

JSON-представление 
{
  "audienceRows": [
    {
      object (AudienceRow)
    }
  ],
  "audienceExport": {
    object (AudienceExport)
  },
  "rowCount": integer
}
Поля
audience Rows[]

object ( AudienceRow )

Строки для каждого пользователя в экспорте аудитории. Количество строк в этом ответе будет меньше или равно размеру страницы запроса.

audience Export

object ( AudienceExport )

Данные конфигурации о запрашиваемом AudienceExport. Вернулся, чтобы помочь интерпретировать строки аудитории в этом ответе. Например, размеры в этом AudienceExport соответствуют столбцам в AudienceRows.

row Count

integer

Общее количество строк в результате AudienceExport. rowCount не зависит от количества строк, возвращаемых в ответе, параметра запроса limit и параметра запроса offset . Например, если запрос возвращает 175 строк и включает limit в 50 в запросе API, ответ будет содержать rowCount равный 175, но только 50 строк.

Дополнительные сведения об этом параметре нумерации страниц см. в разделе Нумерация страниц .

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

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

AudienceRow

Атрибуты значений измерения для строки пользователя аудитории.

JSON-представление 
{
  "dimensionValues": [
    {
      object (AudienceDimensionValue)
    }
  ]
}
Поля
dimension Values[]

object ( AudienceDimensionValue )

Каждый атрибут значения измерения для пользователя аудитории. Одно значение измерения будет добавлено для каждого запрошенного столбца измерения.

АудиторияИзмерениеЗначение

Значение измерения.

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

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
Поля
Поле объединения one_value . Один из видов размерных значений. one_value может быть только одним из следующих:
value

string

Значение в виде строки, если тип измерения является строкой.