Google Analytics API に関する公式のお知らせを参照するには、Google Analytics API Notify Group にご登録ください。
2024 年 5 月 6 日 キーイベント管理メソッドを追加しました
キーイベント用のリソースとメソッドが利用できるようになりました。
ConversionEvent
ではなく KeyEvent
を使用するように API 統合を変更します。ConversionEvent
のサポートが終了しました。
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.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 アルファ版から削除されます。
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 とクライアント ライブラリに対して記述された既存のコードは、それに応じて更新する必要があります。