Google Analytics API に関する公式のお知らせを参照するには、Google Analytics API Notify Group にご登録ください。
2023 年 12 月 15 日 すべての Google アナリティクス プロパティでデータアクセス レポートが利用可能になりました。
データアクセス レポート機能の特定のフィールドを、標準版と Google アナリティクス 360 の両方の Google アナリティクス プロパティでご利用いただけるようになりました。
詳しくは、スキーマのドキュメントをご覧ください。
2023 年 12 月 15 日 データアクセス レポート スキーマに accessDateHour ディメンションが追加されました。
データアクセス レポート スキーマに追加された accessDateHour ディメンション。これには、Google アナリティクス ユーザーが Google アナリティクスのレポートデータにアクセスした日時が含まれます。
2023-10-05 「ファースト クリック」、「線形」、「減衰」、「接点ベース」のアトリビューション モデルを使用しているプロパティでは、デフォルトでクロスチャネル DDA が使用されます。
2023 年 10 月中旬より、ファースト クリック、線形、減衰、接点ベースのアトリビューション モデルは、すべてのプロパティで UpdateAttributionSettings メソッドで使用できなくなります。
これらのモデルのいずれかを使用するようにプロパティが現在設定されている場合は、クロスチャネル データドリブン アトリビューションに変更されます。クロスチャネルのラストクリックまたは広告優先のラストクリックを代わりに使用することもできます。
2023-09-01 SKAdNetwork コンバージョン値スキーマの設定メソッドを追加しました。
Admin API v1alpha に追加された GetSKAdNetworkConversionValueSchema、CreateSKAdNetworkConversionValueSchema、DeleteSKAdNetworkConversionValueSchema、UpdateSKAdNetworkConversionValueSchema、ListSKAdNetworkConversionValueSchemas の各メソッド。
この機能を使用すると、iOS ストリームの SKAdNetwork コンバージョン値スキーマ設定を管理できます。
2023 年 9 月 1 日 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-06-05 アトリビューション モデル「ファースト クリック」、「線形」、「減衰」、「接点ベース」のサポート終了
2023 年 6 月より、UpdateAttributionSettings メソッドで、ファースト クリック、線形、減衰、接点ベースのアトリビューション モデルを使用する GA4 プロパティを設定できなくなります。2023 年 9 月以降、これらのモデルはすべてのプロパティで利用できなくなります。
詳しくは、Google アナリティクスのサービスに関するお知らせをご覧ください。
2023 年 5 月 31 日 AdSense のリンク管理方法を追加しました。
Admin API v1alpha に追加された GetAdSenseLink、CreateAdSenseLink、DeleteAdSenseLink、ListAdSenseLinks メソッド。
この機能により、GA4 プロパティで AdSense とアナリティクスのリンクを管理できます。
2023 年 5 月 31 日 接続された GA4 プロパティを検索する方法を追加しました。
Admin API v1alpha に追加された FetchConnectedGa4Property メソッド
この機能により、GA4 への移行プロセス中に、ユニバーサル アナリティクス プロパティにリンクされた GA4 プロパティに関する情報を取得できます。
2023 年 5 月 31 日 イベント作成ルールを管理するメソッドを追加しました。
Admin API v1alpha に追加された CreateEventCreateRule、UpdateEventCreateRule、DeleteEventCreateRule、ListEventCreateRules、GetEventCreateRule の各メソッド。
この機能を使用すると、イベント作成ルールを管理できます。このルールは、ソースイベントの一致した条件に基づいて、まったく新しいイベントの作成をトリガーできます。
2023 年 5 月 31 日 カスタム チャネル グループを管理するメソッドを追加しました。
Admin API v1alpha に GetChannelGroup、ListChannelGroups、CreateChannelGroup、UpdateChannelGroup、DeleteChannelGroup の各メソッドを追加しました。
この機能を使用すると、ウェブサイトのトラフィック ソースのカスタム チャネル グループを管理できます。
作成したカスタム チャネル グループは、Google Analytics Data API v1 を使用してクエリできます。
2023 年 3 月 31 日 拡張計測機能の設定の管理方法を追加しました。
Admin API v1alpha に追加された properties.dataStreams.updateEnhancedMeasurementSettings メソッドと properties.dataStreams.getEnhancedMeasurementSettings メソッド。
この機能を使用すると、GA4 プロパティのウェブデータ ストリームの拡張計測機能の設定を管理できます。
2023 年 3 月 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 年 2 月 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 リソースが v1alpha バージョンの API に追加され、次の操作も行われました。
accounts.accessBindings.createaccounts.accessBindings.deleteaccounts.accessBindings.patchaccounts.accessBindings.listaccounts.accessBindings.getaccounts.accessBindings.batchCreateaccounts.accessBindings.batchDeleteaccounts.accessBindings.batchUpdateaccounts.accessBindings.batchGetproperties.accessBindings.createproperties.accessBindings.deleteproperties.accessBindings.patchproperties.accessBindings.listproperties.accessBindings.getproperties.accessBindings.batchCreateproperties.accessBindings.batchDeleteproperties.accessBindings.batchUpdateproperties.accessBindings.batchGet
GA4 のアカウントまたはプロパティのユーザー権限を管理できる機能です。ユーザーリンクの代わりに使用することをおすすめします。
ユーザーリンクの機能は、2023 年 6 月 1 日に Admin API v1 アルファ版から削除されます。
2023 年 2 月 24 日 ユーザー権限の監査方法を廃止します。
次のメソッドは非推奨になり、2023 年 6 月 1 日に Admin API v1 アルファ版から削除されます。
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 設定プロセスの自動オプトアウト方法を追加しました。
properties.setAutomatedGa4ConfigurationOptOut、properties.fetchAutomatedGa4ConfigurationOptOut オペレーションが v1alpha バージョンの API に追加されました。
この機能を使用すると、UA プロパティの自動 GA4 設定プロセスのオプトアウト ステータスを管理できます。
2023 年 2 月 15 日 BigQuery のリンク管理メソッドを追加しました。
BigQueryLink リソースが、対応する properties.bigQueryLinks.get、properties.bigQueryLinks.list オペレーションとともに API の v1alpha バージョンに追加されました。
この機能を使用すると、GA4 プロパティと BigQuery プロジェクト間のリンクに関する情報を取得できます。
2023 年 2 月 15 日 検索広告 360 のリンク管理メソッドを追加しました。
SearchAds360Link リソースが、対応する properties.searchAds360Links.create、properties.searchAds360Links.delete、properties.searchAds360Links.patch、properties.searchAds360Links.list、properties.searchAds360Links.get オペレーションとともに API の v1alpha バージョンに追加されました。
この機能を使用すると、GA4 プロパティと検索広告 360 エンティティ間のリンクを管理できます。
2023-02-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値。searchAds360Link、expandedDataSet、bigqueryLinkの値をChangeHistoryResourceに追加しました。
2022-08-11 Admin API v1alpha に runAccessReport メソッドを追加しました。
Admin API の v1alpha バージョンに追加された properties.runAccessReport メソッド。データアクセス レコードのカスタマイズ レポートが返されます。このレポートでは、ユーザーが Google アナリティクスのレポートデータを読み取るたびに記録されています。データアクセス レポートは、Google アナリティクス 360 プロパティの管理者が利用できます。
2022-07-11 Admin API v1beta バージョンをリリースしました。
Google Analytics Admin API の v1beta バージョンがリリースされました。
Admin API では、API のアルファ版チャンネルとベータ版チャンネルの両方が引き続きサポートされます。Beta チャンネルには、アルファ版で利用できる機能のうち、安定版とみなされるため、今後大幅な変更が行われる予定ではないもののサブセットが含まれています。新機能は、完成後にベータ版に追加されます。
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 年 6 月 5 日 機能を追加しました。
API には次の機能が追加されています。
accounts.searchChangeHistoryEventsメソッドが API に追加されました。このメソッドは、指定されたフィルタセットに基づいて、アカウントまたはその子に対するすべての変更を検索します。一般的な原因としては、Google アナリティクスの UI で行われた更新、カスタマー サポートによる変更、Google アナリティクス システムの自動変更などがあります。properties.webDataStreams.measurementProtocolSecretsに追加された Measurement Protocol のシークレット管理メソッド:properties.conversionEventsに追加されたコンバージョン イベント管理メソッド:properties.customDimensionsに、次のカスタム ディメンションの管理メソッドを追加しました。properties.customMetricsに追加されたカスタム指標管理メソッド:- 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 ListFirebaseLinks オペレーションでのページ分割のサポートを追加しました。
2021-01-28 互換性を破る変更。
互換性を破る変更:
- すべての更新オペレーションで update_mask フィールドが必要です。
Accountのcountry_codeフィールドの名前がregion_codeに変更されました。EnhancedMeasurementSettingsのurl_query_parameterフィールドの名前がuri_query_parameterに変更されました。項目「
parent」を「GoogleAdsLink」から削除しました。
2020-10-20 アカウントの概要のサポートを追加しました。
アカウントの概要メソッドのサポートを追加しました。
2020 年 10 月 13 日 アプリ + ウェブ プロパティの名称を Google アナリティクス 4（GA4）に変更しました。
2020-08-15 Management アプリ + ウェブ API の名称を Admin API に変更しました。
Google アナリティクス Management App + Web API の名称が Google Analytics Admin API に変更されました。これに伴い、API エンドポイントは analyticsadmin.googleapis.com に変更されました。以前のバージョンの API エンドポイントの URL とクライアント ライブラリに対して記述された既存のコードは、それに応じて更新する必要があります。