將使用者目標對象名單匯出至 Google 試算表。建立目標對象後,使用者就無法立即取得商店資訊。首先,您必須向 audienceLists.create
提出要求,以便建立使用者名單,接著就能用這個方法將目標對象名單中的這些使用者匯出至 Google 試算表。
如需目標對象名單的簡介和範例,請參閱建立目標對象名單一文。
Google Analytics 4 中的目標對像功能可讓您根據自家業務的需求區隔使用者。詳情請參閱:https://support.google.com/analytics/answer/9267572。
這種方法在 Alpha 版穩定性階段推出,用意是在進入 Beta 版前,先收集有關語法和功能的意見回饋。如要針對這個 API 提供意見回饋,請填寫 Google Analytics Audience Export API 意見回饋表單。
HTTP 要求
POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/audienceLists/*}:exportSheet
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
name |
必要欄位。要擷取使用者的目標對象名單名稱。格式: |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "offset": string, "limit": string } |
欄位 | |
---|---|
offset |
選用設定。起始資料列的列數。第一列會計為第 0 列。 分頁時,第一個要求不會指定位移;或同等規則,將偏移值設為 0;第一個要求會傳回前 如要進一步瞭解這個分頁參數,請參閱「分頁」。 |
limit |
選用設定。要傳回的列數。如未指定,系統會傳回 10,000 列。無論您要求多少列,API 在每個要求最多只能傳回 250,000 列。 如果維度值數量不如 如要進一步瞭解這個分頁參數,請參閱「分頁」。 |
回應主體
已建立的 Google 試算表,內含目標對象名單中的使用者清單。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
---|
{
"spreadsheetUri": string,
"spreadsheetId": string,
"rowCount": integer,
"audienceList": {
object ( |
欄位 | |
---|---|
spreadsheetUri |
URI,您必須在瀏覽器中前往這個 URI 才能查看 Google 試算表。 |
spreadsheetId |
用於識別所建立 Google 試算表資源的 ID。 |
rowCount |
AudienceList 結果中的資料列總數。 如要進一步瞭解這個分頁參數,請參閱「分頁」。 |
audienceList |
匯出的目標對象名單設定資料。返回協助解讀這則回覆 Google 試算表中的目標對象名單。 舉例來說,與 Google 試算表相比, AudienceList 包含的資料列可能比 Google 試算表顯示多,在這種情況下,建議你傳送其他工作表匯出要求 (具有不同的 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets