複数のレポートをまとめて返します。レポートはすべて同じエンティティのものである必要があります。
HTTP リクエスト
POST https://analyticsdata.googleapis.com/v1alpha:batchRunReports
この URL は gRPC Transcoding 構文を使用します。
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
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[] |
読み取るデータの期間。複数の期間をリクエストすると、各レスポンス行にゼロから始まる期間のインデックスが含まれます。2 つの期間が重複している場合は、重複する日のイベントデータが両方の期間のレスポンス行に含まれます。コホート リクエストでは、この |
offset |
開始行の行数。最初の行は行 0 としてカウントされます。 |
limit |
返される行数。 |
metricAggregations[] |
指標の集計。集計された指標値は、dimensionValue が「RESERVED_(MetricAggregation)」に設定されている行に表示されます。 |
dimensionFilter |
ディメンションのフィルタ句。このフィルタで使用するディメンションをリクエストする必要があります。このフィルタでは指標を使用できません。 |
metricFilter |
指標のフィルタ句。SQL with 句と同様に、事後集計フェーズで適用されます。このフィルタで指標を使用するには、リクエストする必要があります。このフィルタではディメンションを使用できません。 |
orderBys[] |
レスポンス内の行の順序を指定します。 |
currencyCode |
ISO4217 形式の通貨コード(「AED」、「USD」、「JPY」など)。このフィールドが空の場合、レポートではエンティティのデフォルトの通貨が使用されます。 |
cohortSpec |
このリクエストに関連付けられているコホート グループ。リクエストにコホート グループがある場合は、「コホート」ディメンションを指定する必要があります。 |
keepEmptyRows |
false または指定されていない場合、すべての指標が 0 に等しい各行は返されません。true の場合、これらの行がフィルタによって個別に削除されない場合に返されます。 |
returnPropertyQuota |
このアナリティクス プロパティの割り当ての現在の状態を返すかどうかを切り替えます。割り当ては PropertyQuota で返されます。 |