Method: properties.audienceLists.create

建立目標對象名單，以便日後擷取。這個方法能快速傳回目標對象名單的資源名稱，並發出長時間執行的非同步要求，以建立目標對象名單。如要列出目標對象名單中的使用者，請先透過這個方法建立目標對象名單，然後將目標對象資源名稱傳送至 audienceLists.query 方法。

如需目標對象名單和範例，請參閱「建立目標對象名單」一文。

目標對象名單是目標對象名單在建立過程中目前目標對像中的使用者。如果建立不同的目標對象名單，並將名單放在不同的日期，當使用者進入及離開目標對象時，就會傳回不同的結果。

Google Analytics (分析) 4 目標對像功能可讓您根據自家業務的需求區隔使用者。詳情請參閱 https://support.google.com/analytics/answer/9267572。目標對象名單包含每個目標對像中的使用者。

此方法適用於 audienceExports.create 的 Beta 版穩定性。如要針對這個 API 提出意見，請填寫 Google Analytics (分析) Audience Export API 意見回饋表單。

HTTP 要求

POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists

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

路徑參數

參數
parent

string

必要欄位。要建立這份目標對象名單的父項資源。格式︰properties/{property}

要求主體

要求主體包含 AudienceList 的例項。

回應主體

如果成功，回應主體會包含新建立的 Operation 例項。

授權範圍

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

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