Data API を使用すると、Google アナリティクス 4(GA4)のレポートデータにプログラムでアクセスできます。この API は、以前のユニバーサル アナリティクス プロパティと互換性がありません。
Google Analytics Data API v1 を使用すると、次のようなデータをレポートできます。
- 前週の Android アプリの 1 日のアクティブ ユーザーの数です。
- サイトの上位 10 ページの過去 28 日間のページビュー数。
- 過去 30 分間に iOS アプリのアクティブ ユーザーが国別だった人数です。
また、Google Analytics Data API v1 を使って次のことも可能です。
- Google アナリティクスのデータを表示するカスタマイズされたマイレポートを作成する。
- 複雑なレポートタスクを自動化して時間を節約する。
- Google アナリティクスのデータを他のビジネス アプリケーションと統合する。
始める
開始するには、クライアント ライブラリのクイックスタートをご覧ください。Java、Python、Node.js などの言語のクライアント ライブラリを使って、簡単に実装できます。
利用可能なメソッド
次のリストは Data API メソッドのリストです。詳細については、リファレンス ドキュメントをご覧ください。
runReport
このメソッドは、Google アナリティクス イベントデータのカスタム レポートを返すため、シンプルなレポートクエリの場合に適しています。batchRunReports
これは runReport メソッドのバッチ バージョンで、1 回の API 呼び出しで複数のレポートを生成できます。runPivotReport
このメソッドは、Google アナリティクス イベントデータのカスタマイズされたピボット レポートを返します。ピボット レポートは、通常のレポートよりも高度で表現力豊かな形式です。各ピボットは、レポート レスポンスに表示されるディメンションの列と行を表します。batchRunPivotReports
これは、1 回の API 呼び出しで複数のレポートを生成できる runPivotReport メソッドのバッチ バージョンです。getMetadata
このメソッドは、レポート メソッドで使用できるディメンションと指標のメタデータを返します。ディメンションと指標を調べるために使用します。このメソッドのレスポンスには、指定した GA4 プロパティで利用可能なカスタム ディメンションとカスタム指標も含まれます。checkCompatibility
このメソッドでは、レポート リクエストに追加でき、互換性を維持できるディメンションと指標をリストします。runRealtimeReport
このメソッドは、プロパティのカスタマイズされたリアルタイム イベントデータ レポートを返します。イベントは、Google アナリティクスに送信されてから数秒後にリアルタイム レポートに表示されます。リアルタイム レポートには、現在から 30 分前(Google アナリティクス 360 プロパティの場合は最大 60 分)の期間のイベントと使用状況データが表示されます。properties.audienceExports
オーディエンス内のユーザーのスナップショットを含むオーディエンスのエクスポートを生成できる一連のメソッドです。properties.recurringAudienceLists
(早期プレビュー版)定期的なオーディエンスのエクスポートを管理できる一連の方法。オーディエンスを定期的にエクスポートすることで、新しいオーディエンス リストが毎日生成されます。runFunnelReport
(早期プレビュー)このメソッドは、Google アナリティクスのイベントデータのカスタマイズされたファネル レポートを返します。ファネル データ探索を使用すると、ユーザーがタスクを完了するまでのステップを視覚化し、各ステップでのユーザーの動向をすばやく確認できます。
サポートされているディメンションと指標
Data API でサポートされているすべてのディメンションと指標のリストについては、API スキーマのドキュメントをご覧ください。