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 数据和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 天为止。系统将发送第一个请求，其中会显示新创建的受众群体名单的“正在创建”状态。第二个请求将在受众群体名单创建完毕（有效或失败状态）后发送。

方法

create

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

get

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

list

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