Google Analytics Admin API の概要

概要: このドキュメントでは、Google アナリティクス Admin API バージョン 1.0 の概要を説明します。

警告: これは API の初期プレビュー バージョンであり、変更される可能性があります。Google は今後の変更についてお知らせする予定ですが、API が一般公開される前に互換性を破る変更が発生する可能性があります。

API の Alpha チャンネルと Beta チャンネルは、引き続きサポートされます。Beta チャンネルには、アルファ版で利用可能な機能の一部が含まれています。それらは安定版と見なされ、今後大規模な変更が行われないと想定されています。ベータ版のリリース時には新機能が追加される予定です。

Google アナリティクス API の公式お知らせについては、Google Analytics API の通知グループにご登録ください。 API に関する問題を報告するには、Google Analytics API Tester フィードバック フォームをご利用ください。

はじめに

Google アナリティクス Admin API を使用すると、Google アナリティクス 4（GA4）の設定データにプログラムでアクセスできます。GA4 プロパティとのみ互換性があります。GA4 のプロパティの詳細もご覧ください。

Google アナリティクス Admin API を使用すると、次のことができます。

• 新しいアカウントをプロビジョニングする。
• アカウントの管理
• データ共有設定を管理する
• アカウントの概要を一覧表示します。
• 検索履歴のイベントを検索します。
• プロパティを管理する。
• ユーザーデータの収集を認める。
• プロパティのデータの保持設定を管理する
• プロパティの Google シグナルの設定を管理する（アルファ版）。
• ストリームの管理。
• Measurement Protocol Secret を管理します。
• ウェブデータ ストリーム用の Google タグ スニペットを生成する（アルファ版）。
• コンバージョン イベントを管理する
• カスタム ディメンションを管理する
• カスタム指標を管理する。
• GA4 プロパティと Firebase プロジェクト間のリンクを管理する
• GA4 プロパティと Google 広告アカウント間のリンクを管理する
• GA4 プロパティとディスプレイ & amp;ビデオ 360 広告主（アルファ版）のリンクに関するプロポーザルを管理する
• GA4 プロパティとディスプレイ & amp;ビデオ 360 広告主（アルファ版）とのリンクを管理する
• アカウント階層と GA4 プロパティ（アルファ版）のユーザー権限を管理する。
• ユーザー権限（グループまたは組織管理者ロールによって付与される有効な権限から取得した暗黙的な権限を含む）を監査します（アルファ版）。
• データアクセス レポート（アルファ版）を生成する。

利用可能なメソッド

アカウント プロビジョニング

• accounts.provisionAccountTicket

  このメソッドは、利用規約（TOS）の URL に含める必要がある accountTicketId フィールドを返します。 https://analytics.google.com/analytics/web/?provisioningSignup=false#/termsofservice/ACCOUNT_TICKET_IDユーザーが TOS URL にアクセスして利用規約に同意すると、Google アナリティクス アカウントの作成が完了します（アカウントのプロビジョニング サンプル）。

アカウント管理

• accounts.delete
• accounts.get
• accounts.list
• accounts.patch

データ共有設定の管理

• accounts.getDataSharingSettings

アカウント概要のリスト

• accountSummaries.list

変更履歴のイベントを検索

• accounts.searchChangeHistoryEvents

不動産管理

• properties.get
• properties.patch
• properties.delete
• properties.list
• properties.create

ユーザーデータの収集確認

• properties.acknowledgeUserDataCollection

データ保持設定の管理

• properties.getData リテンション設定
• properties.updateData リテンション設定

Google シグナルの設定管理（アルファ版）

• properties.getGoogleSignalsSettings
• properties.updateGoogleSignalsSettings

データ ストリーム管理

• properties.dataStreams.create
• properties.dataStreams.get
• properties.dataStreams.list
• properties.dataStreams.patch
• properties.dataStreams.delete

Measurement Protocol Secret 管理

• properties.dataStreams.measurementProtocolSecrets.create
• properties.dataStreams.measurementProtocolSecrets.get
• properties.dataStreams.measurementProtocolSecrets.patch
• properties.dataStreams.measurementProtocolSecrets.list
• properties.dataStreams.measurementProtocolSecrets.delete

コンバージョン イベントの管理

• properties.conversionEvents.create
• properties.conversionEvents.get
• properties.conversionEvents.list
• properties.conversionEvents.delete

カスタム ディメンションの管理

• properties.customDimensions.create
• properties.customDimensions.get
• properties.customDimensions.list
• properties.customDimensions.patch
• properties.customDimensions.archive

カスタム指標の管理

• properties.customMetrics.create
• properties.customMetrics.get
• properties.customMetrics.list
• properties.customMetrics.patch
• properties.customMetrics.archive

Firebase プロジェクトのリンク

• properties.firebaseLinks.create
• properties.firebaseLinks.list
• properties.firebaseLinks.delete

Google 広告アカウントとのリンク

• properties.googleAdsLinks.create
• properties.googleAdsLinks.list
• properties.googleAdsLinks.patch
• properties.googleAdsLinks.delete

Google タグの生成（アルファ版）

• properties.webDataStreams.getGlobalSiteTag

GA4 プロパティとディスプレイ & amp;ビデオ 360 の広告主（アルファ版）のリンクに関するプロポーザル

• properties.displayVideo360ADVERTISERLinkProposals.create
• properties.displayVideo360ADVERTISERLinkProposals.Approve
• properties.displayVideo360ADVERTISERLinkProposals.cancel
• properties.displayVideo360ADVERTISERLinkProposals.list
• properties.displayVideo360ADVERTISERLinkProposals.get
• properties.displayVideo360ADVERTISERLinkProposals.delete

GA4 プロパティとディスプレイ & amp;ビデオ 360 広告主（アルファ版）のリンク。

• properties.displayVideo360ADVERTISERLinks.create
• properties.displayVideo360ADVERTISERLinks.get
• properties.displayVideo360ADVERTISERLinks.list
• properties.displayVideo360ADVERTISERLinks.delete
• properties.displayVideo360ADVERTISERLinks.patch

ユーザー権限の管理（アルファ版）

• accounts.userLinks.create
• accounts.userLinks.get
• accounts.userLinks.list
• accounts.userLinks.patch
• accounts.userLinks.delete
• accounts.userLinks.batchCreate
• accounts.userLinks.batchGet
• accounts.userLinks.batchUpdate

• accounts.userLinks.batchDelete

• properties.userLinks.create

• properties.userLinks.get

• properties.userLinks.list

• properties.userLinks.delete

• properties.userLinks.patch

• properties.userLinks.batchCreate

• properties.userLinks.batchGet

• properties.userLinks.batchUpdate

• properties.userLinks.batchDelete

ユーザー権限の監査（アルファ版）

• accounts.userLinks.audit
• properties.userLinks.audit

データアクセス レポート（アルファ版）

• properties.runAccessReport この機能について詳しくは、データアクセス レポート ガイドをご覧ください。