資源:RecurringAudienceList
週期性目標對象名單每天都會產生新的目標對象名單。目標對象名單是指建立名單時目標對像中的使用者。週期性目標對象名單可確保系統根據每日可用的最新資料,為您提供目標對象名單。
JSON 表示法 |
---|
{ "name": string, "audience": string, "audienceDisplayName": string, "dimensions": [ { object ( |
欄位 | |
---|---|
name |
僅供輸出。ID。在建立期間指派的週期性目標對象名單資源名稱。此資源名稱可識別這個 格式︰ |
audience |
必要欄位。目標對象資源名稱。這個資源名稱會用來識別列出的目標對象,並在 Analytics (分析) Data & Admin API 之間共用。 格式︰ |
audienceDisplayName |
僅供輸出。此目標對象的描述性顯示名稱。例如「購買者」。 |
dimensions[] |
必要欄位。要求及顯示在目標對象名單回應中的維度。 |
audienceLists[] |
僅供輸出。為這份週期性目標對象名單建立的目標對象名單例項,其目標對象名單資源名稱。系統會每天建立一份目標對象名單,且該名單會列在這裡。 這份清單會優先由最近建立的目標對象名單排序。 |
activeDaysRemaining |
選用設定。週期性目標對象匯出作業將產生目標對象名單例項的剩餘天數。這種計數器每天會減少 1 次,如果達到零,系統就不會建立新的目標對象名單。 Analytics (分析) 360 資源的週期性目標對象名單要求預設為 180 天,最長為 365 天。標準 Analytics (分析) 資源的要求預設為 14 天,上限為 30 天。 建立期間的下限值是 1。達到相應上限的要求將強制調整為上限。 |
webhookNotification |
選用設定。設定 Webhook 通知從 Google Analytics (分析) Data API 傳送至 Webhook 伺服器。使用 Webhook 是選擇性的。如果未使用,您必須輪詢這個 API,判斷週期性目標對象名單在何時新建目標對象名單。Webhook 可讓系統將通知傳送到您的伺服器,讓您不必進行輪詢。 每當週期性目標對象名單建立目標對象名單,系統就會傳送兩個 POST 要求。系統會每天執行一次,直到週期性目標對象名單的剩餘有效天數達 0 天為止。系統會傳送第一個要求,顯示新建的目標對象名單處於「建立中」狀態。目標對象名單建立完成後 (狀態為「有效」或「失敗」) 後,系統就會傳送第二個請求。 |
方法 |
|
---|---|
|
建立週期性目標對象名單。 |
|
取得特定週期性目標對象名單的設定中繼資料。 |
|
列出資源的所有週期性目標對象名單。 |