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（分析）Data & Admin API 之间共享。

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

string

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

object (AudienceDimension)

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

string

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

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

integer

可选。导出定期受众群体生成受众群体名单实例的剩余天数。此计数器每天减少 1，当该值为零时，系统将不会创建新的受众群体名单。

Analytics 360 媒体资源的周期性受众群体名单请求默认设置为 180 天，最长为 365 天。针对标准 Google Analytics（分析）媒体资源的请求默认设置为 14 天，最长 30 天。

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

object (WebhookNotification)

可选。配置要从 Google Analytics（分析）Data API 发送到您的网络钩子服务器的网络钩子通知。使用网络钩子是可选操作。如果未使用，您需要轮询此 API，以确定周期性受众群体名单何时创建新的受众群体名单。借助网络钩子，您可以向服务器发送通知，避免进行轮询。

每次定期生成的受众群体名单创建受众群体名单时，系统会发送两个 POST 请求。此过程每天进行一次，直到周期性受众群体名单的剩余有效天数达到 0 天。系统将发送第一个请求，显示新创建的受众群体名单处于“正在创建”状态。第二个请求将在受众群体名单创建完毕后（状态为 ACTIVE 或 FAILED）发送。

方法

create

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

get

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

list

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