REST Resource: properties.recurringAudienceLists

Ресурс: RecurringAudienceList

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

JSON-представление
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "audienceLists": [
    string
  ],
  "activeDaysRemaining": integer,
  "webhookNotification": {
    object (WebhookNotification)
  }
}
Поля
name

string

Только вывод. Идентификатор. Имя ресурса списка повторяющейся аудитории, присвоенное при создании. Это имя ресурса идентифицирует этот RecurringAudienceList .

Формат: properties/{property}/recurringAudienceLists/{recurringAudienceList}

audience

string

Необходимый. Имя ресурса аудитории. Это имя ресурса идентифицирует указанную аудиторию и используется совместно API-интерфейсами данных аналитики и администрирования.

Формат: properties/{property}/audiences/{audience}

audienceDisplayName

string

Только вывод. Описательное отображаемое имя для этой аудитории. Например, «Покупатели».

dimensions[]

object ( AudienceDimension )

Необходимый. Параметры, запрошенные и отображаемые в ответе списка аудитории.

audienceLists[]

string

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

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

activeDaysRemaining

integer

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

Повторяющийся запрос списка аудитории для ресурсов Analytics 360 по умолчанию составляет 180 дней, но не может превышать 365 дней. Запросы на стандартные свойства Google Analytics по умолчанию составляют 14 дней, но не более 30 дней.

Минимальное значение, разрешенное во время создания, равно 1. Запросы, превышающие соответствующий максимум, будут принудительно увеличены до максимального значения.

webhookNotification

object ( WebhookNotification )

Необязательный. Настраивает уведомления веб-перехватчика для отправки из API данных Google Analytics на ваш сервер веб-перехватчиков. Использование вебхуков не является обязательным. Если он не используется, вам потребуется опросить этот API, чтобы определить, когда повторяющийся список аудитории создает новые списки аудитории. Вебхуки позволяют отправлять уведомления на ваши серверы и исключают необходимость опроса.

Два запроса POST будут отправляться каждый раз, когда повторяющийся список аудитории создает список аудитории. Это происходит один раз в день, пока в списке повторяющейся аудитории не останется 0 активных дней. Первый запрос будет отправлен, показывая вновь созданный список аудитории в состоянии СОЗДАНИЕ. Второй запрос будет отправлен после завершения создания списка аудитории (состояние ACTIVE или FAILED).

Методы

create

 Создает повторяющийся список аудитории.

get

 Получает метаданные конфигурации для определенного повторяющегося списка аудитории.

list

 Перечисляет все повторяющиеся списки аудитории для ресурса.