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

必需。受众群体资源名称。此资源名称用于标识要列出的受众群体，并在 Google Analytics 数据 API 和 Admin API 之间共享。

格式：properties/{property}/audiences/{audience}
audienceDisplayName

string

仅限输出。此受众群体的描述性显示名称。例如“买家”。
dimensions[]

object (AudienceDimension)

必需。请求的维度以及受众群体名单响应中显示的维度。
audienceLists[]

string

仅限输出。为此周期性受众群体名单创建的受众群体名单实例的受众群体名单资源名称。系统每天会创建一个受众群体名单，并将该受众群体名单列在此处。

此列表会按最近创建的受众群体名单的顺序排列。
activeDaysRemaining

integer

可选。定期导出受众群体后，系统还会再产生受众群体名单实例的天数。此计数器每天会减少 1，当计数器达到 0 时，系统将不会再创建新的受众群体名单。

Google Analytics 360 媒体资源的周期性受众群体名单请求的默认有效期为 180 天，最长可达 365 天。标准版 Google Analytics 媒体资源的请求默认有效期为 14 天，最长可达 30 天。

在创建期间，允许的最小值为 1。超出各自上限的请求将被强制转换为上限。
webhookNotification

object (WebhookNotification)

可选。配置要从 Google Analytics Data API 发送到 webhook 服务器的 webhook 通知。使用 webhook 是可选的。如果未使用，您需要轮询此 API 以确定周期性受众群体名单何时创建新的受众群体名单。借助 Webhook，您可以向服务器发送通知，而无需轮询。

每次周期性受众群体名单创建受众群体名单时，系统都会发送两个 POST 请求。这种情况每天会发生一次，直到周期性受众群体名单的剩余有效天数达到 0 为止。系统会发送第一个请求，其中显示新创建的受众群体名单处于“正在创建”状态。第二个请求将在受众群体列表创建完成（处于“有效”或“失败”状态）后发送。

方法

create

 创建周期性受众群体名单。

get

 获取有关特定周期性受众群体名单的配置元数据。

list

 列出媒体资源的所有周期性受众群体名单。