試用 Google Analytics 的 MCP 伺服器。從
GitHub 安裝,詳情請參閱
公告。
Method: properties.reportTasks.create
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
開始建立報表工作。這個方法能快速傳回報表工作,並開始長時間執行的非同步要求,以建立 Google Analytics (分析) 事件資料的自訂報表。
系統會保留報表工作,可在建立後 72 小時內查詢。
凡是可存取該項資源的使用者,都能列出及查詢一位使用者建立的報表工作。
HTTP 要求
POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/reportTasks
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
parent |
string
必要欄位。要建立這個報表工作的父項資源。格式︰properties/{propertyId}
|
要求主體
要求主體包含 ReportTask
的例項。
回應主體
如果成功,回應主體會包含新建立的 Operation
例項。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eInitiates a long-running asynchronous request to create a customized report of Google Analytics event data.\u003c/p\u003e\n"],["\u003cp\u003eCreated report tasks are retained and available for querying for 72 hours.\u003c/p\u003e\n"],["\u003cp\u003eReport tasks are accessible to all users with property access.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with either \u003ccode\u003ehttps://www.googleapis.com/auth/analytics.readonly\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/analytics\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This describes the process to create a report task for Google Analytics event data. A `POST` request is sent to `https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/reportTasks`, where `parent` specifies the property. The request body must include a `ReportTask` instance. Upon success, it will respond with an `Operation` instance. Authorization requires either the `analytics.readonly` or `analytics` scope. Created tasks are retained for 72 hours and accessible to all property users.\n"],null,["# Method: properties.reportTasks.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nInitiates the creation of a report task. This method quickly returns a report task and initiates a long running asynchronous request to form a customized report of your Google Analytics event data.\n\nA report task will be retained and available for querying for 72 hours after it has been created.\n\nA report task created by one user can be listed and queried by all users who have access to the property.\n\n### HTTP request\n\n`POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/reportTasks`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent resource where this report task will be created. Format: `properties/{propertyId}` |\n\n### Request body\n\nThe request body contains an instance of [ReportTask](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.reportTasks#ReportTask).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/analytics/devguides/reporting/data/v1/rest/Shared.Types/Operation).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/analytics.readonly`\n- `https://www.googleapis.com/auth/analytics`"]]