変更履歴

Google アナリティクス API の公式発表については、Google Analytics API Notify Group に登録してください。

2026-06-18 UpdateReportingIdentitySettings メソッドを追加しました

2026-06-18 PropertySummary に can_edit フィールドを追加しました

  • Admin API v1alpha と v1beta の PropertySummary リソースに can_edit フィールドを追加しました。このフィールドは、ユーザーがプロパティの設定を変更できる Google アナリティクスのロールを持っているかどうかを示します。

2026-04-14 GetUserProvidedDataSettings メソッドを追加しました

2025-08-20 GetReportingIdentitySettings メソッドを追加しました

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

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

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

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-09-09 アクセス レポートのアンケート フォーム

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

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

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

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

2024-08-01 createSubproperty メソッドに対する互換性を破る変更

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

2024-08-01 イベント編集ルールの管理を追加

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

EventEditRule は、ソースイベントの一致条件に基づいて、まったく新しいイベントの作成をトリガーする条件を定義します。さらに、EventEditRule では、ソースイベントのパラメータの変更を定義できます。

2024-08-01 その他の変更

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

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

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

2024-05-06 キーイベント管理メソッドを追加

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

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

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

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

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

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

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

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

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

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

2023-09-01 SKAdNetwork コンバージョンの値スキーマの設定方法を追加しました。

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

この機能を使用すると、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 年 7 月 14 日 properties.updateAttributionSettings、properties.getAttributionSettings メソッドに互換性を破る変更が加えられました。

2023 年 7 月 24 日より、Admin API v1 alpha に互換性を破る変更が加えられます。この変更は、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 フィールドを追加しました

AttributionSettings タイプに ads_web_conversion_data_export_scope フィールドを追加しました。このフィールドは、UpdateAttributionSettings メソッドを使用して変更できます。

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

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

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

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

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

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

Admin API v1alpha に追加された FetchConnectedGa4Property メソッド

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

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

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

この機能を使用すると、イベント作成ルールを管理できます。このルールでは、ソースイベントの一致条件に基づいて、まったく新しいイベントの作成をトリガーできます。

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

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

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

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

2023-03-31 拡張計測機能の設定の管理メソッドを追加しました。

properties.dataStreams.updateEnhancedMeasurementSettings、properties.dataStreams.getEnhancedMeasurementSettings メソッドが Admin API v1alpha に追加されました。

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

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

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

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

2023-03-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 で拡張データセットを管理するために使用できます。

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

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

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

2023-02-24 ユーザー権限の監査メソッドのサポートを終了しました。

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

2023-02-24 オーディエンス マネージャーのメソッドを追加しました。

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

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

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

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

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

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

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

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

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

2023-02-15 互換性を破る変更。

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

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

2022-08-11 runAccessReport メソッドが Admin API v1alpha に追加されました。

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

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

Google Analytics Admin API の v1beta バージョンがリリースされました。

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

2021-10-12 EnhancedMeasurementSettings メソッドが API から削除されました。

  • 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 に次の機能が追加されました。

  • accounts.searchChangeHistoryEvents メソッドが API に追加されました。このメソッドは、指定されたフィルタセットに基づいて、アカウントまたはその子のすべての変更を検索します。一般的な原因としては、Google アナリティクス UI で行われた更新、カスタマー サポートによる変更、Google アナリティクス システムの自動変更などが挙げられます。
  • properties.dataStreams.measurementProtocolSecrets に Measurement Protocol のシークレット管理メソッドが追加されました。
    • create Measurement Protocol の秘密鍵を作成します。
    • delete ターゲットの Measurement Protocol のシークレットを削除します。
    • get 1 つの Measurement Protocol Secret を検索します。
    • list 指定された親プロパティの下位にある子 Measurement Protocol シークレットを返します。
    • patch Measurement Protocol の Secret を更新します。
  • properties.conversionEvents にコンバージョン イベント管理メソッドを追加しました。
    • create 指定された属性を持つコンバージョン イベントを作成します。
    • delete プロパティのコンバージョン イベントを削除します。
    • get 1 つのコンバージョン イベントを取得します。
    • 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 互換性を破る変更。

次の互換性を破る変更が導入されました。

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

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

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

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

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

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

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

account summaries メソッドのサポートを追加しました。

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

2020-08-15 Management App + Web API の名前を Admin API に変更しました。

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