批次傳回多份報表。所有報表都必須來自同一個 GA4 資源。
HTTP 要求
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunReports
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
property |
要追蹤事件的 Google Analytics GA4 資源 ID。指定在網址路徑,而不是內文。詳情請參閱「如何查看資源 ID」一文。必須為批次指定此屬性。RunReportRequest 中的屬性可能未指定或與這個屬性一致。 範例:properties/1234 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"requests": [
{
object ( |
欄位 | |
---|---|
requests[] |
個別要求。每個請求都有個別的報表回應。每個批次要求最多可包含 5 個要求。 |
回應主體
包含多份報表的批次回應。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
---|
{
"reports": [
{
object ( |
欄位 | |
---|---|
reports[] |
個別回應。每個回應都有個別的報表要求。 |
kind |
識別這則訊息的資源類型。此 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
RunReportRequest
產生報表的要求。
JSON 表示法 |
---|
{ "property": string, "dimensions": [ { object ( |
欄位 | |
---|---|
property |
要追蹤事件的 Google Analytics GA4 資源 ID。指定在網址路徑,而不是內文。詳情請參閱「如何查看資源 ID」一文。在批次要求中,這個屬性應未指定或與批次層級屬性一致。 範例:properties/1234 |
dimensions[] |
要求和顯示的維度。 |
metrics[] |
要求和顯示的指標。 |
dateRanges[] |
要讀取資料的日期範圍。如果要求多個日期範圍,則每個回應列都會包含以零為基準的日期範圍索引。如果兩個日期範圍重疊,這兩個日期範圍的回應列就會包含重疊日期的事件資料。在同類群組要求中,您必須指定這個 |
dimensionFilter |
維度篩選器,在報表中篩選出特定維度值。詳情請參閱「維度篩選器的基本知識」一文。無法在這個篩選器中使用指標。 |
metricFilter |
指標的篩選器子句。系統匯總報表的資料列後套用,與 SQL 包含子句類似。無法在這個篩選器中使用維度。 |
offset |
起始資料列的列數。第一列會計為第 0 列。 分頁時,第一個要求不會指定位移;或等於,將偏移值設為 0;第一個要求會傳回前 如要進一步瞭解這個分頁參數,請參閱「分頁」。 |
limit |
要傳回的列數。如未指定,系統會傳回 10,000 列。無論您要求多少列,API 在每個要求最多只能傳回 250,000 列。 如果維度值數量不如 如要進一步瞭解這個分頁參數,請參閱「分頁」。 |
metricAggregations[] |
指標匯總。匯總指標值會顯示在 dimensionValues 設為「RESERVED_(MetricAggregation)」的資料列中。 |
orderBys[] |
指定在回應中資料列的排序方式。 |
currencyCode |
採用 ISO4217 格式的貨幣代碼,例如「AED」、「USD」、「JPY」。如果該欄位空白,報表就會採用資源的預設貨幣。 |
cohortSpec |
與這項要求相關聯的同類群組。如果要求中已有同類群組群組維度。 |
keepEmptyRows |
如果為 false 或未指定,系統不會傳回所有指標都等於 0 的資料列。在設為 true 的情況下,如果篩選器沒有個別移除這些資料列,系統就會傳回這些資料列。 無論這項 舉例來說,如果資源從未記錄 |
returnPropertyQuota |
切換是否要傳回這項 Analytics 資源的配額目前狀態。配額會在 PropertyQuota 中傳回。 |
comparisons[] |
選用設定。要求及顯示的比較設定。這項要求只需要比較欄位,即可在回應中接收比較資料欄。 |