Google Analytics API の公式なお知らせを受け取るには、Google Analytics API Notify グループにご登録ください。
2025-01-20 DataRetentionSettings にユーザーデータの保持を追加しました
Admin API v1alpha と v1beta の DataRetentionSettings に userDataRetention フィールドを追加しました。このフィールドは、ユーザーデータの保持設定を取得または変更するために使用します。
2024-09-09 アクセス レポートに関するアンケート フォーム
runAccessReport メソッドのドキュメントが更新され、Google アナリティクスのアクセス レポートに関するフィードバック フォームへのリンクが追加されました。皆様からの貴重なご意見を今後の API の改善に活用させていただきます。ご意見をお寄せください。
2024-08-01 BigQuery リンク管理を追加しました
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-05 「ファースト クリック」、「線形」、「減衰」、「接点ベース」のアトリビューション モデルが設定されているプロパティは、デフォルトでクロスチャネル 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 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-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 アナリティクス 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 メソッドを追加しました。
properties.runAccessReport メソッドと accounts.runAccessReport メソッドが、Admin API の v1beta バージョンに追加されました。メソッドは、カスタマイズされたデータアクセス レコードのレポートを返します。
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.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 アカウントまたはプロパティのユーザー権限を管理できます。ユーザーリンクの代わりに使用してください。
ユーザーリンク機能は、6 月 1 日（23 日）に Admin API v1 アルファ版から削除されます
2023 年 2 月 24 日 ユーザー権限監査メソッドの非推奨化。
次のメソッドは非推奨となり、2023 年 6 月 1 日に Admin API v1 alpha から削除されます。
2023-02-24 オーディエンス管理メソッドを追加しました。
Audience リソースが、対応する properties.audience.create、properties.audience.archive、properties.audience.patch、properties.audience.list、properties.audience.get オペレーションとともに、API の v1alpha バージョンに追加されました。
この機能を使用すると、GA4 プロパティのオーディエンスを管理できます。
2023-02-15 GA4 の自動設定プロセスのオプトアウト方法を追加しました。
properties.setAutomatedGa4ConfigurationOptOut、properties.fetchAutomatedGa4ConfigurationOptOut オペレーションが v1alpha バージョンの API に追加されました。
この機能を使用すると、UA プロパティの GA4 自動設定プロセスのオプトアウト ステータスを管理できます。
2023-02-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 互換性を破る変更。
LESS_THAN_OR_EQUAL、GREATER_THAN_OR_EQUAL値をNumericFilter.Operation列挙型から削除。PARTIAL_REGEXP値がStringFilter.MatchType列挙型から削除されました。
2023-02-15 その他の変更。
tokensPerProjectPerHourフィールドをAccessQuotaタイプに追加しました。EXPANDED_DATA_SET、CHANNEL_GROUPの値がChangeHistoryResourceType列挙型に追加されました。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 の Alpha チャンネルと 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-06-05 機能を追加しました。
この API には、次の機能が追加されています。
accounts.searchChangeHistoryEventsメソッドが API に追加されました。このメソッドは、指定された一連のフィルタに基づいて、アカウントまたはその子に対するすべての変更を検索します。一般的な原因としては、Google アナリティクスの管理画面での更新、カスタマー サポートによる変更、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フィールドが必須になりました。deletedフィールドをPropertyタイプから削除。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に変更しました。parentフィールドをGoogleAdsLinkから削除しました。
2020 年 10 月 20 日 アカウントの概要のサポートを追加しました。
アカウントの概要メソッドのサポートを追加しました。
2020-10-13 アプリ + ウェブ プロパティの名前を Google アナリティクス 4（GA4）に変更しました。
2020 年 8 月 15 日 管理アプリとウェブ API の名前を Admin API に変更しました。
Google Analytics Management App + Web API の名前が Google Analytics Admin API に変更されました。そのため、API エンドポイントは analyticsadmin.googleapis.com に変更されました。以前のバージョンの API エンドポイント URL とクライアント ライブラリに対して記述された既存のコードを、それに応じて更新する必要があります。