Method: properties.audienceExports.list

列出資源的所有目標對象匯出項目。您可以使用這個方法找出並重複使用現有的目標對象匯出資料,而非建立不必要的新目標對象匯出資料。同一個目標對象可以有多個目標對象匯出作業,代表在不同日期內,目標對象內的使用者匯出作業。

如要瞭解目標對象匯出功能,並查看相關範例,請參閱「建立目標對象匯出作業」。

Audience Export API 中有些方法處於 Alpha 版,其他方法則處於 Beta 版。我們希望在收集到一些意見回饋並開始採用後,能將方法推進 Beta 版穩定性。如要針對這個 API 提供意見,請填寫 Google Analytics Audience Export API 意見回饋表單。

HTTP 要求

GET https://analyticsdata.googleapis.com/v1beta/{parent=properties/*}/audienceExports

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

路徑參數

參數
parent

string

必要欄位。回應中會列出此資源的所有目標對象匯出項目。格式:properties/{property}

查詢參數

參數
pageSize

integer

選用設定。要傳回的目標對象匯出作業數量上限。服務傳回的產品數量可能會少於這個值。如未指定,最多將傳回 200 個目標對象匯出項目。許可的最大值為 1000 (較高的值會強制設為最大值)。

pageToken

string

選用設定。從先前 audienceExports.list 呼叫收到的網頁權杖。提供此項目即可擷取後續網頁。

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

要求主體

要求主體必須為空白。

回應主體

資源的所有目標對象匯出項目清單。

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

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

object (AudienceExport)

每個資源的目標對象匯出作業。

nextPageToken

string

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

授權範圍

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

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