複数のレポートをまとめて返します。レポートはすべて同じ GA4 プロパティのものである必要があります。
HTTP リクエスト
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunReports
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
property |
イベントがトラッキングされる Google アナリティクス GA4 プロパティの識別子。本文ではなく URL パスで指定します。詳しくは、プロパティ 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 アナリティクス GA4 プロパティの識別子。本文ではなく URL パスで指定します。詳しくは、プロパティ ID を確認する方法をご覧ください。バッチ リクエスト内では、このプロパティを指定しないか、バッチレベルのプロパティと一致させる必要があります。 例: properties/1234 |
dimensions[] |
リクエストされ、表示されたディメンション。 |
metrics[] |
リクエストされ、表示される指標。 |
dateRanges[] |
読み取るデータの期間。複数の期間をリクエストすると、各レスポンス行にゼロから始まる期間のインデックスが含まれます。2 つの期間が重複している場合は、重複する日のイベントデータが両方の期間のレスポンス行に含まれます。コホート リクエストでは、この |
dimensionFilter |
ディメンション フィルタを使用すると、特定のディメンション値のみをレポートに表示できます。詳細については、ディメンション フィルタの基礎で例をご覧ください。このフィルタでは指標を使用できません。 |
metricFilter |
指標のフィルタ句。SQL with 句と同様に、レポートの行を集計した後に適用されます。このフィルタではディメンションを使用できません。 |
offset |
開始行の行数。最初の行は行 0 としてカウントされます。 ページングの際に、最初のリクエストで offset が指定されていません。または、これと同等に、offset を 0 に設定します。最初のリクエストは、行の最初の このページ設定パラメータの詳細については、ページ設定をご覧ください。 |
limit |
返される行数。指定しない場合は、10,000 行が返されます。API は、リクエストした数に関係なく、リクエストあたり最大 250,000 行を返します。 また、ディメンション値の数が このページ設定パラメータの詳細については、ページ設定をご覧ください。 |
metricAggregations[] |
指標の集計。集計された指標値は、dimensionValue が「RESERVED_(MetricAggregation)」に設定されている行に表示されます。 |
orderBys[] |
レスポンス内の行の順序を指定します。 |
currencyCode |
ISO4217 形式の通貨コード(「AED」、「USD」、「JPY」など)。このフィールドが空の場合、レポートではプロパティのデフォルトの通貨が使用されます。 |
cohortSpec |
このリクエストに関連付けられているコホート グループ。リクエストにコホート グループがある場合は、「コホート」ディメンションを指定する必要があります。 |
keepEmptyRows |
false または指定されていない場合、すべての指標が 0 に等しい各行は返されません。true の場合、これらの行がフィルタによって個別に削除されない場合に返されます。 この たとえば、あるプロパティで |
returnPropertyQuota |
このアナリティクス プロパティの割り当ての現在の状態を返すかどうかを切り替えます。割り当ては PropertyQuota で返されます。 |
comparisons[] |
省略可。リクエストおよび表示される比較の設定。レスポンスで比較列を取得するために必要となるのは、Comparisons フィールドのみです。 |