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 スキーマのドキュメントをご覧ください。