変更履歴

Google アナリティクス API の公式なお知らせを受け取るには、グループの Google Analytics API Notify にご登録ください。

2025 年 8 月 20 日 GetReportingIdentitySettings メソッドを追加しました

Admin API v1alpha に GetReportingIdentitySettings メソッドを追加しました。このメソッドを使用すると、プロパティの ReportingIdentitySettings を取得できます。

2025-08-20 以前のユニバーサル アナリティクス メソッドを削除

次の以前のユニバーサル アナリティクス（UA）メソッドが Admin API v1alpha から削除されました: SetAutomatedGa4ConfigurationOptOut、FetchAutomatedGa4ConfigurationOptOut、CreateConnectedSiteTag、DeleteConnectedSiteTag、ListConnectedSiteTags、FetchConnectedGa4Property。

2025-06-12 サブプロパティの同期構成管理メソッドを追加しました

Admin API v1alpha で SubpropertySyncConfig リソースを管理するための GetSubpropertySyncConfig、ListSubpropertySyncConfig、UpdateSubpropertySyncConfig メソッドを追加しました。

2025-04-16 レポート データ アノテーション管理メソッドを追加しました

Admin API v1alpha で ReportingDataAnnotation リソースを管理するための CreateReportingDataAnnotation、GetReportingDataAnnotation、ListReportingDataAnnotations、UpdateReportingDataAnnotation、DeleteReportingDataAnnotation メソッドを追加しました。

メモを使用すると、Google アナリティクスのレポートに注釈を直接追加できるため、イベントの記録、データの変化に関する説明、自分やチームにとって重要な所見の表示を簡単に行うことができます。

2025 年 3 月 7 日 sharingWithGoogleAnySalesEnabled パラメータの非推奨化

getDataSharingSettings メソッドの sharingWithGoogleAnySalesEnabled パラメータは非推奨になり、常に false を返すようになります。このフィールドは、2025 年 6 月に Google Analytics Admin API v1beta から削除されます。

2025-01-20 DataRetentionSettings にユーザーデータの保持を追加

Admin API v1alpha と v1beta の DataRetentionSettings に userDataRetention フィールドを追加しました。このフィールドを使用して、ユーザーデータの保持設定を取得または変更します。

2024 年 9 月 9 日 アクセス レポートのアンケート フォーム

runAccessReport メソッドのドキュメントが更新され、Google アナリティクス アクセス レポートのフィードバック フォームへのリンクが追加されました。皆様からのご意見を参考に、この API のさらなる改善に努めてまいります。

2024 年 8 月 1 日 BigQuery リンクの管理を追加しました

Admin API v1alpha で BigQueryLink リソースを管理するための CreateBigQueryLink、UpdateBigQueryLink、DeleteBigQueryLink メソッドを追加しました。

BigQueryLink リソースに dataset_location フィールドを追加しました。

ChangeHistoryResourceType の新しい BIGQUERY_LINK 値の下の変更履歴に、BigQuery リンクの変更を追加しました。

2024 年 8 月 1 日 createSubproperty メソッドの互換性を破る変更

カスタム メソッドのガイドラインに沿って、Admin API v1alpha の createSubproperty カスタム メソッドの名前を provisionSubproperty に変更しました。

2024 年 8 月 1 日 イベント編集ルールの管理を追加しました

Admin API v1alpha に追加された GetEventEditRule、CreateEventEditRule、DeleteEventEditRule、ListEventEditRules、UpdateEventEditRules、ReorderEventEditRules メソッド。

EventEditRule は、ソースイベントの条件に一致した場合に、完全に新しいイベントの作成をトリガーする条件を定義します。また、EventEditRule はソースイベントのパラメータの変更を定義できます。

2024 年 8 月 1 日 その他の変更

Audience リソースに create_time を追加しました。

ChannelGroup リソースに primary を追加して、チャネル グループがレポートのデフォルトのチャネル グループかどうかを示します。primary を true に設定できるチャネル グループは、一度に 1 つだけです。チャネル グループの primary を true に設定すると、以前のメインのチャネル グループの primary が自動的に false に設定されます。

Account リソースに gmp_organization を追加しました。アカウントが Google マーケティング プラットフォームの組織に接続されている場合、このリソースには Google マーケティング プラットフォームの組織リソースの URI が含まれます。

2024 年 5 月 6 日 キーイベント管理メソッドを追加しました

キーイベントのリソースとメソッドが利用可能になりました。

ConversionEvent ではなく KeyEvent を使用するように API 統合を変更します。ConversionEvent は非推奨となりました。

2023 年 12 月 15 日: すべての Google アナリティクス プロパティでデータアクセス レポートをご利用いただけるようになりました。

データアクセス レポート機能の特定のフィールドが、標準の Google アナリティクスと Google アナリティクス 360 の両方をご利用のお客様を対象に、すべての Google アナリティクス プロパティで利用できるようになりました。

詳細については、スキーマのドキュメントをご覧ください。

2023 年 12 月 15 日 データアクセス レポートのスキーマに accessDateHour ディメンションを追加しました。

データアクセス レポートのスキーマに accessDateHour ディメンションが追加されました。これには、GA のユーザーが GA のレポートデータにアクセスした日時が含まれます。

2023 年 10 月 5 日: アトリビューション モデル「ファースト クリック」、「線形」、「減衰」、「接点ベース」を使用しているプロパティのデフォルトが、クロスチャネル DDA に変更されます。

2023 年 10 月中旬以降、すべてのプロパティで、ファースト クリック、線形、減衰、接点ベースのアトリビューション モデルを UpdateAttributionSettings メソッドで使用できなくなります。

プロパティで現在これらのモデルのいずれかが使用されている場合は、クロスチャネル データドリブン アトリビューションに変更されます。代わりに、クロスチャネルのラストクリックまたは広告優先のラストクリックを使用することもできます。

2023 年 9 月 1 日 SKAdNetwork コンバージョン値スキーマの設定方法を追加しました。

Admin API v1alpha に GetSKAdNetworkConversionValueSchema、CreateSKAdNetworkConversionValueSchema、DeleteSKAdNetworkConversionValueSchema、UpdateSKAdNetworkConversionValueSchema、ListSKAdNetworkConversionValueSchemas メソッドが追加されました。

この機能を使用すると、iOS ストリームの SKAdNetwork コンバージョン値スキーマ設定を管理できます。

2023-09-01 UpdateConversionEvent メソッドを追加しました。

Admin API v1beta に UpdateConversionEvent メソッドを追加しました。

2023-09-01 BigQueryLink.enterprise_export_enabled フィールドの名前が fresh_daily_export_enabled に変更されました。

BigQueryLink リソースの enterprise_export_enabled フィールドの名前が fresh_daily_export_enabled に変更されました。

2023-07-14 properties.updateAttributionSettings、properties.getAttributionSettings メソッドへの互換性を破る変更。

2023 年 7 月 24 日より、Admin API v1 アルファに重大な変更が加えられ、properties.getAttributionSettings メソッドと properties.updateAttributionSettings メソッドの機能に影響します。

ReportingAttributionModel 列挙型のメンバーの名前は次のように変更されます。

以前の名前	新しい名前
CROSS_CHANNEL_DATA_DRIVEN	PAID_AND_ORGANIC_CHANNELS_DATA_DRIVEN
CROSS_CHANNEL_LAST_CLICK	PAID_AND_ORGANIC_CHANNELS_LAST_CLICK
CROSS_CHANNEL_FIRST_CLICK	PAID_AND_ORGANIC_CHANNELS_FIRST_CLICK
CROSS_CHANNEL_LINEAR	PAID_AND_ORGANIC_CHANNELS_LINEAR
CROSS_CHANNEL_POSITION_BASED	PAID_AND_ORGANIC_CHANNELS_POSITION_BASED
CROSS_CHANNEL_TIME_DECAY	PAID_AND_ORGANIC_CHANNELS_TIME_DECAY
ADS_PREFERRED_LAST_CLICK	GOOGLE_PAID_CHANNELS_LAST_CLICK

AdsWebConversionDataExportScope 列挙型のメンバーの名前は次のように変更されます。

以前の名前	新しい名前
CROSS_CHANNEL	PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED	GOOGLE_PAID_CHANNELS

2023-07-10 AttributionSettings 型に ads_web_conversion_data_export_scope フィールドを追加しました

UpdateAttributionSettings メソッドを使用して変更できる AttributionSettings 型に ads_web_conversion_data_export_scope フィールドを追加しました。

2023 年 6 月 5 日: アトリビューション モデル「ファースト クリック」、「線形」、「減衰」、「接点ベース」のサポート終了。

2023 年 6 月以降、UpdateAttributionSettings メソッドを使用して、ファースト クリック、線形、減衰、接点ベースのアトリビューション モデルで GA4 プロパティを構成することはできません。2023 年 9 月より、これらのモデルはすべてのプロパティで利用できなくなります。

詳しくは、Google アナリティクスのプロダクトに関するお知らせをご覧ください。

2023 年 5 月 31 日 AdSense リンクの管理方法を追加しました。

Admin API v1alpha に GetAdSenseLink、CreateAdSenseLink、DeleteAdSenseLink、ListAdSenseLinks メソッドが追加されました。

この機能を使用すると、GA4 プロパティの AdSense とアナリティクスのリンクを管理できます。

2023-05-31 接続された GA4 プロパティを検索するメソッドを追加しました。

Admin API v1alpha に FetchConnectedGa4Property メソッドを追加

この機能を使用すると、GA4 への移行プロセス中に、ユニバーサル アナリティクス プロパティにリンクされている GA4 プロパティに関する情報を取得できます。

2023 年 5 月 31 日: イベント作成ルールを管理するメソッドを追加しました。

Admin API v1alpha に CreateEventCreateRule、UpdateEventCreateRule、DeleteEventCreateRule、ListEventCreateRules、GetEventCreateRule メソッドを追加しました。

この機能を使用すると、ソースイベントの条件に一致した場合に完全に新しいイベントの作成をトリガーできるイベント作成ルールを管理できます。

2023-05-31 カスタム チャネル グループを管理するメソッドを追加しました。

Admin API v1alpha に GetChannelGroup、ListChannelGroups、CreateChannelGroup、UpdateChannelGroup、DeleteChannelGroup メソッドを追加しました。

この機能を使用すると、ウェブサイトのトラフィック ソースのカスタム チャネル グループを管理できます。

作成したカスタム チャネル グループは、Google アナリティクス Data API v1 を使用してクエリできます。

2023-03-31 拡張計測機能の設定の管理方法を追加しました。

Admin API v1alpha に properties.dataStreams.updateEnhancedMeasurementSettings メソッドと properties.dataStreams.getEnhancedMeasurementSettings メソッドを追加しました。

この機能を使用すると、GA4 プロパティのウェブデータ ストリームの拡張計測機能の設定を管理できます。

2023-03-31 接続済みのサイトタグの管理方法を追加しました。

Admin API v1alpha に properties.createConnectedSiteTag、properties.deleteConnectedSiteTag、properties.listConnectedSiteTags メソッドが追加されました。

この機能を使用すると、接続済みのサイトタグを管理できます。ユニバーサル アナリティクス プロパティから Google アナリティクス 4 プロパティにトラフィックを転送する場合に便利です。

2023 年 3 月 31 日 Admin API v1beta にアカウントとプロパティ レベルの runAccessReport メソッドを追加しました。

Admin API の v1beta バージョンに追加された properties.runAccessReport メソッドと accounts.runAccessReport メソッド。メソッドは、カスタマイズされたデータアクセス レコードのレポートを返します。

2023-02-24 拡張データセットの管理方法を追加しました。

ExpandedDataSet リソースが、対応する properties.expandedDataSets.create、properties.expandedDataSets.delete、properties.expandedDataSets.patch、properties.expandedDataSets.list、properties.expandedDataSets.get オペレーションとともに、API の v1alpha バージョンに追加されました。この機能は、Google アナリティクス 360 の拡張データセットの管理に使用できます。

2023 年 2 月 24 日: ユーザー権限の管理で、ユーザーリンクがアクセス バインディングに置き換えられます。

AccessBinding リソースが API の v1alpha バージョンに追加されました。次のオペレーションも追加されています。

• accounts.accessBindings.create
• accounts.accessBindings.delete
• accounts.accessBindings.patch
• accounts.accessBindings.list
• accounts.accessBindings.get
• accounts.accessBindings.batchCreate
• accounts.accessBindings.batchDelete
• accounts.accessBindings.batchUpdate
• accounts.accessBindings.batchGet
• properties.accessBindings.create
• properties.accessBindings.delete
• properties.accessBindings.patch
• properties.accessBindings.list
• properties.accessBindings.get
• properties.accessBindings.batchCreate
• properties.accessBindings.batchDelete
• properties.accessBindings.batchUpdate
• properties.accessBindings.batchGet

この機能を使用すると、GA4 アカウントまたはプロパティのユーザー権限を管理できます。ユーザーリンクの代わりにこの機能を使用してください。

ユーザーリンク機能は、2023 年 6 月 1 日に Admin API v1 アルファ版から削除されます

2023 年 2 月 24 日 ユーザー権限監査メソッドの非推奨化。

次のメソッドは非推奨となり、2023 年 6 月 1 日に Admin API v1 アルファから削除されます。

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

2023 年 2 月 24 日: オーディエンス管理メソッドを追加しました。

Audience リソースが、対応する properties.audience.create、properties.audience.archive、properties.audience.patch、properties.audience.list、properties.audience.get オペレーションとともに、API の v1alpha バージョンに追加されました。

この機能を使用すると、GA4 プロパティのオーディエンスを管理できます。

2023 年 2 月 15 日: GA4 の自動設定プロセスのオプトアウト方法を追加しました。

API の v1alpha バージョンに properties.setAutomatedGa4ConfigurationOptOut、properties.fetchAutomatedGa4ConfigurationOptOut オペレーションが追加されました。

この機能を使用すると、UA プロパティの GA4 自動設定プロセスのオプトアウト ステータスを管理できます。

2023 年 2 月 15 日 BigQuery リンクの管理方法を追加しました。

BigQueryLink リソースが、対応する properties.bigQueryLinks.get、properties.bigQueryLinks.list オペレーションとともに、API の v1alpha バージョンに追加されました。

この機能を使用すると、GA4 プロパティと BigQuery プロジェクト間のリンクに関する情報を取得できます。

2023-02-15 検索広告 360 のリンクの管理方法を追加しました。

SearchAds360Link リソースが、対応する properties.searchAds360Links.create、properties.searchAds360Links.delete、properties.searchAds360Links.patch、properties.searchAds360Links.list、properties.searchAds360Links.get オペレーションとともに、API の v1alpha バージョンに追加されました。

この機能を使用すると、GA4 プロパティと検索広告 360 エンティティ間のリンクを管理できます。

2023 年 2 月 15 日 互換性を破る変更。

• NumericFilter.Operation 列挙型から LESS_THAN_OR_EQUAL、GREATER_THAN_OR_EQUAL の値を削除しました。

• StringFilter.MatchType 列挙型から PARTIAL_REGEXP 値を削除しました。

2023-02-15 その他の変更。

• AccessQuota 型に tokensPerProjectPerHour フィールドを追加しました。
• ChangeHistoryResourceType 列挙型に EXPANDED_DATA_SET、CHANNEL_GROUP の値が追加されました。
• ChangeHistoryResource に searchAds360Link、expandedDataSet、bigqueryLink の値が追加されました。

2022 年 8 月 11 日: Admin API v1alpha に runAccessReport メソッドが追加されました。

Admin API の v1alpha バージョンに properties.runAccessReport メソッドを追加しました。データアクセス レコードのカスタマイズされたレポートが返されます。このレポートには、ユーザーが Google アナリティクス レポートデータを読み取ったときの記録がすべて表示されます。データアクセス レポートは、Google アナリティクス 360 プロパティの管理者が利用できます。

2022 年 7 月 11 日: Admin API v1beta バージョンがリリースされました。

Google アナリティクス Admin API の v1beta バージョンがリリースされました。

Admin API では、API の Alpha チャンネルと Beta チャンネルの両方が引き続きサポートされます。ベータ版チャンネルには、アルファ版で利用可能な機能のサブセットが含まれています。これらの機能は安定しているとみなされ、今後の大幅な変更は予定されていません。新しい機能は、成熟するとベータ版に追加されます。

2021 年 10 月 12 日: API から EnhancedMeasurementSettings メソッドを削除しました。

• properties.webDataStreams.getEnhancedMeasurementSettings、properties.webDataStreams.updateEnhancedMeasurementSettings メソッドが API から削除されましたが、拡張計測の設定は、まもなく API 経由で再度変更できるようになります。
• UserLink リソースの directRoles フィールドは、predefinedRoles/manage-users ロールをサポートしなくなりました。代わりに、新しい predefinedRoles/admin ロールを使用する必要があります。これは、以前の predefinedRoles/edit ロールと predefinedRoles/manage-users ロールの組み合わせと同等です。この変更は accounts.userLinks、properties.userLinks メソッドの動作に影響し、Google アナリティクスで導入されたアクセス権とデータ制限の管理の変更に沿ったものです。

2021-06-05 機能を追加しました。

API に次の機能が追加されます。

• API に accounts.searchChangeHistoryEvents メソッドを追加しました。このメソッドは、指定されたフィルタのセットに基づいて、アカウントまたはその子に対するすべての変更を検索します。一般的な原因としては、Google アナリティクスの UI で行われた更新、カスタマー サポートによる変更、Google アナリティクスのシステムによる自動変更などが考えられます。
• properties.webDataStreams.measurementProtocolSecrets に Measurement Protocol Secret の管理メソッドを追加しました。
  • create Measurement Protocol のシークレットを作成します。
  • delete ターゲット Measurement Protocol シークレットを削除します。
  • get 単一の Measurement Protocol シークレットを検索します。
  • list 指定された親プロパティの子 Measurement Protocol Secret を返します。
  • patch Measurement Protocol Secret を更新します。
• properties.conversionEvents にコンバージョン イベント管理メソッドを追加しました。
  • create 指定された属性でコンバージョン イベントを作成します。
  • delete プロパティのコンバージョン イベントを削除します。
  • get 単一のコンバージョン イベントを取得します。
  • list 指定された親プロパティのコンバージョン イベントのリストを返します。
• properties.customDimensions にカスタム ディメンション管理メソッドを追加しました。
  • archive プロパティのカスタム ディメンションをアーカイブします。
  • create カスタム ディメンションを作成します。
  • get 単一のカスタム ディメンションのルックアップ。
  • list プロパティのカスタム ディメンションを一覧表示します。
  • patch プロパティのカスタム ディメンションを更新します。
• properties.customMetrics にカスタム指標管理メソッドを追加しました。
  • archive プロパティのカスタム指標をアーカイブします。
  • create カスタム指標を作成します。
  • get 単一のカスタム指標を検索します。
  • list プロパティのカスタム指標を一覧表示します。
  • patch プロパティのカスタム指標を更新します。
• Google アナリティクス 4 プロパティの Google シグナル設定を制御できる properties.getGoogleSignalsSettings、properties.updateGoogleSignalsSettings メソッドを追加しました。
• delete_time、expire_time 出力専用フィールドが Property 型に追加されました。

2021-06-05 互換性を破る変更。

次の互換性を損なう変更が導入されました。

• API から properties.iosAppDataStreams.create メソッドと properties.androidAppDataStreams.create メソッドが削除されました。Firebase を使用して、Google アナリティクス 4 プロパティにアプリ ストリームを作成してください。
• properties.delete メソッドが、空のレスポンスを返すのではなく、削除されたプロパティ データを Property 型で返すようになりました。
• Property 型の time_zone フィールドが必須になりました。
• Property 型から deleted フィールドを削除しました。
• UserLink 型の email_address フィールドが変更できなくなりました。
• UserLink タイプの name フィールドは出力専用になりました。

2021-01-28 ListFirebaseLinks オペレーションのページネーションのサポートを追加しました。

2021-01-28 互換性を破る変更。

互換性を破る変更: - すべての Update オペレーションで update_mask フィールドが必須になりました。

• Account で country_code フィールドの名前が region_code に変更されました。

• EnhancedMeasurementSettings で url_query_parameter フィールドの名前が uri_query_parameter に変更されました。

• GoogleAdsLink から parent フィールドを削除しました。

2020-10-20 アカウントの概要のサポートを追加しました。

アカウントの概要メソッドのサポートを追加しました。

2020 年 10 月 13 日: アプリ + ウェブ プロパティの名前が Google アナリティクス 4（GA4）に変更されました。

2020 年 8 月 15 日: Management App と Web API の名前が Admin API に変更されました。

Google アナリティクス Management App + Web API の名前が Google アナリティクス Admin API に変更されました。その結果、API エンドポイントが analyticsadmin.googleapis.com に変更されました。以前のバージョンの API エンドポイント URL とクライアント ライブラリに対して記述された既存のコードは、それに応じて更新する必要があります。