一次傳回多份報表。所有報表都必須屬於同一實體。
HTTP 要求
POST https://analyticsdata.googleapis.com/v1alpha:batchRunReports
這個網址使用 gRPC 轉碼語法。
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 | |
---|---|
{ "entity": { object ( |
欄位 | |
---|---|
entity |
追蹤事件的資源。必須為批次指定這個實體。RunReportRequest 中的實體可能未指定或與這個實體一致。 |
requests[] |
個別要求。每個要求都有個別的報表回應。每個批次要求最多可以提出 5 個要求。 |
回應主體
如果成功,回應主體即會包含具有以下結構的資料:
含有多份報表的批次回應。
JSON 表示法 | |
---|---|
{
"reports": [
{
object ( |
欄位 | |
---|---|
reports[] |
個別回應。每個回應都有個別的報表要求。 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
RunReportRequest
產生報表的要求。
JSON 表示法 | |
---|---|
{ "entity": { object ( |
欄位 | |
---|---|
entity |
追蹤事件的資源。在批次要求中,這個實體應未指定或與批次層級實體一致。 |
dimensions[] |
要求及顯示的維度。 |
metrics[] |
要求及顯示的指標, |
dateRanges[] |
要讀取的資料日期範圍。如果要求多個日期範圍,則每個回應列都會包含以 0 為基礎的日期範圍索引。如果兩個日期範圍重疊,這兩個日期範圍的事件資料會納入這兩個日期範圍的回應列中。在同類群組要求中,不得指定這個 |
offset |
起始資料列的列數。第一列會計為第 0 列。 |
limit |
要傳回的列數。如未指定 |
metricAggregations[] |
指標匯總。匯總指標值會顯示在 DimensionsValue 設為「RESERVED_(MetricAggregation)」的資料列中。 |
dimensionFilter |
維度的篩選器子句。必須要求在這個篩選器中使用維度。這個篩選器無法使用指標。 |
metricFilter |
指標的篩選器子句。套用於匯總後階段,與 SQL 有子句類似。您必須要求指標,才能在這個篩選器中使用。無法在這個篩選器中使用維度。 |
orderBys[] |
指定資料列在回應中的排序方式。 |
currencyCode |
採用 ISO4217 格式的貨幣代碼,例如「AED」、「USD」、「JPY」。如果這個欄位空白,報表就會使用實體的預設貨幣。 |
cohortSpec |
與這項要求相關聯的同類群組。如果請求中有同類群組群組,就必須顯示「同類群組」維度。 |
keepEmptyRows |
如為 false 或未指定,則不會傳回所有指標等於 0 的每一列。如果設為 true,如果未遭到篩選器單獨移除,系統就會傳回這些資料列。 |
returnPropertyQuota |
切換是否要傳回這項 Analytics (分析) 資源的配額目前的狀態。系統會在 PropertyQuota 中傳回配額。 |