REST Resource: properties.recurringAudienceLists

{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "audienceLists": [
    string
  ],
  "activeDaysRemaining": integer,
  "webhookNotification": {
    object (WebhookNotification)
  }
}

string

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

格式︰properties/{property}/recurringAudienceLists/{recurringAudienceList}

string

必要欄位。目標對象資源名稱。這個資源名稱會用來識別列出的目標對象，並在 Analytics (分析) Data & Admin API 之間共用。

格式︰properties/{property}/audiences/{audience}

string

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

object (AudienceDimension)

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

string

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

這份清單會優先由最近建立的目標對象名單排序。

integer

選用設定。週期性目標對象匯出作業將產生目標對象名單例項的剩餘天數。這種計數器每天會減少 1 次，如果達到零，系統就不會建立新的目標對象名單。

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

建立期間的下限值是 1。達到相應上限的要求將強制調整為上限。

object (WebhookNotification)

選用設定。設定 Webhook 通知從 Google Analytics (分析) Data API 傳送至 Webhook 伺服器。使用 Webhook 是選擇性的。如果未使用，您必須輪詢這個 API，判斷週期性目標對象名單在何時新建目標對象名單。Webhook 可讓系統將通知傳送到您的伺服器，讓您不必進行輪詢。

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