Method: properties.recurringAudienceLists.list

列出特定資源的所有週期性目標對象名單。這樣一來，您就能找出並重複使用現有的週期性目標對象名單，不必另外建立週期性目標對象名單。同一個目標對象可以有多份週期性目標對象名單，這些名單代表不同的維度組合；例如僅包含 deviceId 維度，或同時包含 deviceId 和 userId 維度。

這種方法在 Alpha 版穩定性階段推出，用意是在進入 Beta 版前，先收集有關語法和功能的意見回饋。如要針對這個 API 提供意見回饋，請填寫 Google Analytics Audience Export API 意見回饋表單。

HTTP 要求

GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

必要欄位。這個資源的所有週期性目標對象名單都會列在回應中。格式：properties/{property}

查詢參數

參數
pageSize

integer

選用設定。可傳回的週期性目標對象名單數量上限。服務傳回的產品數量可能會少於這個值。如未指定，系統最多會傳回 200 份週期性目標對象名單。最大值為 1000 (系統會將這個值越大，一律轉換為最大值)。
pageToken

string

選用設定。屬於接收自前一個 recurringAudienceLists.list 呼叫的網頁權杖。提供此項目即可擷取後續網頁。

進行分頁時，提供至 recurringAudienceLists.list 的所有其他參數須與提供網頁權杖的呼叫相符。

要求主體

要求主體必須為空白。

回應主體

某資源中所有週期性目標對象名單的清單。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "recurringAudienceLists": [
    {
      object (RecurringAudienceList)
    }
  ],
  "nextPageToken": string
}
欄位
recurringAudienceLists[]

object (RecurringAudienceList)

房源每份週期性目標對象名單。
nextPageToken

string

可做為 pageToken 傳送的權杖，用於擷取後續網頁。如果省略這個欄位，就不會有後續頁面。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics