REST Resource: properties.recurringAudienceLists

資源：RecurringAudienceList

定期目標對象名單會每天產生新的目標對象名單。目標對象名單是指建立名單時，目標對象中的使用者。定期更新目標對象名單，可確保您每天都能根據最新資料使用目標對象名單。

JSON 表示法 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "audienceLists": [
    string
  ],
  "activeDaysRemaining": integer,
  "webhookNotification": {
    object (WebhookNotification)
  }
}
欄位
name

string

僅供輸出。ID。建立時指派的週期性目標對象名單資源名稱。這個資源名稱可識別此 RecurringAudienceList。

格式：properties/{property}/recurringAudienceLists/{recurringAudienceList}
audience

string

必要欄位。目標對象資源名稱。這個資源名稱會識別所列目標對象，並在 Analytics 資料與管理員 API 之間共用。

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

string

僅供輸出。這個目標對象的描述性顯示名稱。例如「購買者」。
dimensions[]

object (AudienceDimension)

必要欄位。目標對象名單回應中要求及顯示的維度。
audienceLists[]

string

僅供輸出。為這項週期性目標對象名單建立的目標對象名單例項資源名稱。系統會為每天建立一份目標對象名單，並列出這份名單。

這份清單會依最近建立的目標對象名單排序。
activeDaysRemaining

integer

選用設定。持續性目標對象匯出作業產生目標對象名單例項的剩餘天數。這個計數器每天會減少一個，當計數器歸零時，系統就不會建立新的目標對象名單。

Analytics 360 資源的週期性目標對象名單要求預設為 180 天，最長為 365 天。標準 Analytics 資源的要求預設為 14 天，最長為 30 天。

建立時允許的最小值為 1。超過各自上限的要求會強制設為上限。
webhookNotification

object (WebhookNotification)

選用設定。設定從 Google Analytics Data API 傳送至 webhook 伺服器的 webhook 通知。您可以選擇是否要使用 webhook。如果未使用，您必須輪詢這個 API，才能判斷週期性目標對象名單何時建立新的目標對象名單。Webhooks 可將通知傳送至伺服器，避免需要輪詢。

每次週期性目標對象名單建立目標對象名單時，系統都會傳送兩個 POST 要求。這項作業每天會執行一次，直到週期性目標對象名單的剩餘有效天數為 0 為止。系統會傳送第一個要求，顯示新建立的目標對象名單處於「建立中」狀態。目標對象名單建立完成 (處於「ACTIVE」或「FAILED」狀態) 後，系統會傳送第二個要求。

方法

create

 建立週期性目標對象名單。

get

 取得特定重複目標對象清單的設定中繼資料。

list

 列出資源的所有週期性目標對象清單。