For official Google Analytics API announcements, please subscribe to
[Google Analytics API Notify Group](https://groups.google.com/forum/#!forum/google-analytics-api-notify).

## **2026-06-18** Added `UpdateReportingIdentitySettings` method

- Added the [`UpdateReportingIdentitySettings`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/updateReportingIdentitySettings) method to the Admin API *v1alpha* , which lets you update the [`ReportingIdentitySettings`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/ReportingIdentitySettings) for a property.

## **2026-06-18** Added `can_edit` field to `PropertySummary`

- Added the `can_edit` field to the [`PropertySummary`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accountSummaries/list#propertysummary) resource in the Admin API *v1alpha* and *v1beta*. This field indicates whether the user has a Google Analytics role that permits them to change settings on the property.

## **2026-04-14** Added `GetUserProvidedDataSettings` method

- Added the
  [`GetUserProvidedDataSettings`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/getUserProvidedDataSettings)
  method to the Admin API v1alpha, which lets you retrieve the
  [`UserProvidedDataSettings`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/UserProvidedDataSettings)
  for a property.

- Added the
  [`UserProvidedDataSettings`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/UserProvidedDataSettings)
  resource to the Admin API v1alpha, which includes the [user-provided data
  collection](https://support.google.com/analytics/answer/14077171) fields
  `userProvidedDataCollectionEnabled` and
  `automaticallyDetectedDataCollectionEnabled`.

## **2025-08-20** Added `GetReportingIdentitySettings` method

Added the
[`GetReportingIdentitySettings`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/getReportingIdentitySettings)
method to the Admin API v1alpha, which lets you retrieve the
[`ReportingIdentitySettings`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/ReportingIdentitySettings)
for a property.

## **2025-08-20** Removed legacy Universal Analytics methods

The following legacy Universal Analytics (UA) methods have been removed from the
Admin API v1alpha: `SetAutomatedGa4ConfigurationOptOut`,
`FetchAutomatedGa4ConfigurationOptOut`,
`CreateConnectedSiteTag`, `DeleteConnectedSiteTag`, `ListConnectedSiteTags`, and
`FetchConnectedGa4Property`.

## **2025-06-12** Added subproperty sync configuration management methods

Added
[`GetSubpropertySyncConfig`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.subpropertySyncConfigs/get),
[`ListSubpropertySyncConfig`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.subpropertySyncConfigs/list),
and
[`UpdateSubpropertySyncConfig`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.subpropertySyncConfigs/patch)
methods for managing
[`SubpropertySyncConfig`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.subpropertySyncConfigs)
resources with the Admin API v1alpha.

## **2025-04-16** Added Reporting Data Annotation management methods

Added
[`CreateReportingDataAnnotation`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.reportingDataAnnotations/create),
[`GetReportingDataAnnotation`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.reportingDataAnnotations/get),
[`ListReportingDataAnnotations`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.reportingDataAnnotations/list),
[`UpdateReportingDataAnnotation`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.reportingDataAnnotations/patch)
and
[`DeleteReportingDataAnnotation`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.reportingDataAnnotations/delete)
methods for managing
[`ReportingDataAnnotation`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.reportingDataAnnotations)
resources with the Admin API v1alpha.

[Annotations](https://support.google.com/analytics/answer/15884203) allow users
to add notes directly to Google Analytics reports, making it easier to record
events, explain changes in data, or highlight key observations for yourself and
your team.

## **2025-03-07** Deprecating the `sharingWithGoogleAnySalesEnabled` parameter

The `sharingWithGoogleAnySalesEnabled` parameter of the
[`getDataSharingSettings`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1beta/accounts/getDataSharingSettings)
method is now deprecated and will always return `false`. The field will be
removed from the Google Analytics Admin API v1beta in June, 2025.

## **2025-01-20** Added user data retention to `DataRetentionSettings`

Added the `userDataRetention` field to
[`DataRetentionSettings`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1beta/DataRetentionSettings) in the
Admin API v1alpha and v1beta. Use this field to retrieve or modify retention
settings for user data.

## **2024-09-09** Access Reports survey form

The documentation for the
[`runAccessReport`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts/runAccessReport)
method has been updated to include a link to the
[Google Analytics Access Reports feedback](https://docs.google.com/forms/d/e/1FAIpQLSdmEBUrMzAEdiEKk5TV5dEHvDUZDRlgWYdQdAeSdtR4hVjEhw/viewform)
form. We value your input and encourage you to share your thoughts on this
API to help us improve it further.

## **2024-08-01** Added BigQuery link management

Added `CreateBigQueryLink`, `UpdateBigQueryLink`, and `DeleteBigQueryLink`
methods for managing
[`BigQueryLink`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.bigQueryLinks) resources with
the Admin API v1alpha.

Added the `dataset_location` field to the `BigQueryLink` resource.

Added BigQuery link changes to change history under the new `BIGQUERY_LINK`
value in
[`ChangeHistoryResourceType`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts/searchChangeHistoryEvents#ChangeHistoryResourceType).

## **2024-08-01** Breaking change to the `createSubproperty` method

Renamed the `createSubproperty` custom method to
[`provisionSubproperty`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/provisionSubproperty)
in the Admin API v1alpha to align with [custom method
guidelines](https://google.aip.dev/136).

## **2024-08-01** Added event edit rule management

[`GetEventEditRule`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.eventEditRules/get),
[`CreateEventEditRule`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.eventEditRules/create),
[`DeleteEventEditRule`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.eventEditRules/delete),
[`ListEventEditRules`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.eventEditRules/list),
[`UpdateEventEditRules`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.eventEditRules/patch),
[`ReorderEventEditRules`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.eventEditRules/reorder),
methods added to the Admin API v1alpha.

An `EventEditRule` defines conditions that will trigger the creation of an
entirely new event based upon matched criteria of a source event. In addition,
an `EventEditRule` can define modifications of the parameters from the source
event.

## **2024-08-01** Miscellaneous changes

Added `create_time` to the
[`Audience`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.audiences) resource.

Added `primary` to the
[`ChannelGroup`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.channelGroups) resource to
indicate if the channel group is the default channel group for reports. Only one
channel group can have `primary` set to `true` at any given time. Setting
`primary` to `true` for a channel group automatically sets `primary` to `false`
for the previous primary channel group.

Added `gmp_organization` to the [`Account`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts)
resource, which contains the URI for a Google Marketing Platform organization
resource if the account is connected to a GMP organization.

## **2024-05-06** Added key events management methods

Resources and methods for [key
events](https://support.google.com/analytics/answer/13965727) are now available.

Modify your API integration to use
[`KeyEvent`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1beta/properties.keyEvents) instead of
[`ConversionEvent`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1beta/properties.conversionEvents).
`ConversionEvent` is deprecated.

## **2023-12-15** Data access reports are now available for all Google Analytics properties.

Certain fields of the [Data access reports](https://developers.google.com/analytics/devguides/config/admin/v1/access-api) feature
are now available for all Google Analytics properties, both Standard
and Google Analytics 360 customers.

See the [schema documentation](https://developers.google.com/analytics/devguides/config/admin/v1/access-api-schema) for more information.

## **2023-12-15** The `accessDateHour` dimension added to the Data access report schema.

The `accessDateHour` dimension added to the
[Data access report schema](https://developers.google.com/analytics/devguides/config/admin/v1/access-api-schema). It contains the date hour
of the GA user that accessed GA reporting data.

## **2023-10-05** Properties with first-click, linear, time-decay and position-based attribution models default to cross-channel DDA.

Starting in mid-October 2023, the [first-click](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/AttributionSettings#ReportingAttributionModel),
[linear](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/AttributionSettings#ReportingAttributionModel),
[time-decay](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/AttributionSettings#ReportingAttributionModel)
and [position-based](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/AttributionSettings#ReportingAttributionModel)
attribution models will be unavailable to use with the [UpdateAttributionSettings](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/updateAttributionSettings)
method for all properties.

If your property is currently configured to use one of these models,
it will be changed to
[cross-channel data-driven attribution](https://support.google.com/analytics/answer/11538060).
You will still have the
options to use Cross-channel last click or Ads-preferred last
click instead.

## **2023-09-01** Added SKAdNetwork conversion value schema configuration methods.

[`GetSKAdNetworkConversionValueSchema`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.sKAdNetworkConversionValueSchema/get),
[`CreateSKAdNetworkConversionValueSchema`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.sKAdNetworkConversionValueSchema/create),
[`DeleteSKAdNetworkConversionValueSchema`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.sKAdNetworkConversionValueSchema/delete),
[`UpdateSKAdNetworkConversionValueSchema`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.sKAdNetworkConversionValueSchema/patch),
[`ListSKAdNetworkConversionValueSchemas`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.sKAdNetworkConversionValueSchema/list)
methods added to the Admin API v1alpha.

This functionality allows managing the [SKAdNetwork conversion value schema
configuration](https://support.google.com/analytics/answer/13165271)
for an iOS stream.

## **2023-09-01** Added `UpdateConversionEvent` method.

[`UpdateConversionEvent`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1beta/properties.conversionEvents/patch)
method added to the Admin API v1beta.

## **2023-09-01** `BigQueryLink.enterprise_export_enabled` field renamed to `fresh_daily_export_enabled`.

The `enterprise_export_enabled` field of the `BigQueryLink` resource renamed to
[`fresh_daily_export_enabled`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.bigQueryLinks#BigQueryLink.FIELDS.fresh_daily_export_enabled).

## **2023-07-14** Breaking changes to `properties.updateAttributionSettings`, `properties.getAttributionSettings` methods.

Starting July 24th, 2023, breaking changes will be made to the Admin API v1
alpha which will affect the functionality of
[properties.getAttributionSettings](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/getAttributionSettings),
[properties.updateAttributionSettings](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/updateAttributionSettings)
methods.

Members of the [`ReportingAttributionModel`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/AttributionSettings#ReportingAttributionModel)
enum will be renamed as follows:

| Old name | New name |
|---|---|
| `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` |

Members of the [`AdsWebConversionDataExportScope`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/AttributionSettings#AdsWebConversionDataExportScope)
enum will be renamed as follows:

| Old name | New name |
|---|---|
| `CROSS_CHANNEL` | `PAID_AND_ORGANIC_CHANNELS` |
| `ADS_PREFERRED` | `GOOGLE_PAID_CHANNELS` |

## **2023-07-10** Added the `ads_web_conversion_data_export_scope` field to the `AttributionSettings` type

Added the `ads_web_conversion_data_export_scope` field to the
`AttributionSettings` type which can be modified using the
[`UpdateAttributionSettings`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/updateAttributionSettings)
method.

## **2023-06-05** Deprecation of first-click, linear, time-decay and position-based attribution models.

Starting June 2023, the [UpdateAttributionSettings](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/updateAttributionSettings)
method cannot be used to configure GA4 properties with
[first-click](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/AttributionSettings#ReportingAttributionModel),
[linear](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/AttributionSettings#ReportingAttributionModel),
[time-decay](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/AttributionSettings#ReportingAttributionModel)
and [position-based](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/AttributionSettings#ReportingAttributionModel)
attribution models. Starting in September 2023, these models will become
unavailable for all properties.

Refer to the [Google Analytics product announcement](https://support.google.com/analytics/answer/9164320#040623)
for more information.

## **2023-05-31** Added AdSense links management methods.

[`GetAdSenseLink`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.adSenseLinks/get),
[`CreateAdSenseLink`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.adSenseLinks/create),
[`DeleteAdSenseLink`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.adSenseLinks/delete),
[`ListAdSenseLinks`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.adSenseLinks/list)
methods added to the Admin API v1alpha.

This functionality allows managing [AdSense to Analytics links](https://support.google.com/adsense/answer/6084409)
for a GA4 property.

## **2023-05-31** Added a method to lookup a connected GA4 property.

The [`FetchConnectedGa4Property`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/fetchConnectedGa4Property)
method added to the Admin API v1alpha

This functionality allows to obtain information about a
[GA4 property linked your Universal Analytics property](https://support.google.com/analytics/answer/13342757)
during the GA4 migration process.

## **2023-05-31** Added method to manage event creation rules.

The [`CreateEventCreateRule`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.eventCreateRules/create),
[`UpdateEventCreateRule`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.eventCreateRules/patch),
[`DeleteEventCreateRule`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.eventCreateRules/delete),
[`ListEventCreateRules`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.eventCreateRules/list),
[`GetEventCreateRule`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.eventCreateRules/get) methods added to the Admin API v1alpha.

This functionality allows to manage
[event creation rules](https://support.google.com/analytics/answer/10085872)
which can trigger the creation of an entirely new event based upon matched
criteria of a source event.

## **2023-05-31** Added methods to manage custom channel groups.

Added [`GetChannelGroup`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.channelGroups/get),
[`ListChannelGroups`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.channelGroups/list),
[`CreateChannelGroup`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.channelGroups/create),
[`UpdateChannelGroup`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.channelGroups/patch),
[`DeleteChannelGroup`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.channelGroups/delete)
methods to the Admin API v1alpha.

This functionality allows to manage
[custom channel groups](https://support.google.com/analytics/answer/13051316)
for your website's traffic sources.

Once created, custom channel groups can be queried using the
[Google Analytics Data API v1](https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema#custom_channel_groups).

## **2023-03-31** Added Enhanced Measurement Settings management methods.

The [`properties.dataStreams.updateEnhancedMeasurementSettings`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams/updateEnhancedMeasurementSettings), [`properties.dataStreams.getEnhancedMeasurementSettings`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams/getEnhancedMeasurementSettings) methods added to the Admin API v1alpha.

This functionality allows managing [Enhanced Measurement Settings](https://support.google.com/analytics/answer/9216061) for a Web Data Stream of a GA4 property.

## **2023-03-31** Added Connected Site Tag management methods.

The [`properties.createConnectedSiteTag`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/createConnectedSiteTag), [`properties.deleteConnectedSiteTag`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/deleteConnectedSiteTag), [`properties.listConnectedSiteTags`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/listConnectedSiteTags) methods added to the Admin API v1alpha.

This functionality allows managing [Connected Site Tags](https://support.google.com/analytics/answer/9973999) and is useful for forwarding traffic from a Universal Analytics property to a Google Analytics 4 property.

## **2023-03-31** Added account and property-level `runAccessReport` methods to Admin API v1beta.

The [`properties.runAccessReport`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1beta/properties/runAccessReport)
and [`accounts.runAccessReport`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1beta/accounts/runAccessReport)
methods added to the *v1beta* version of the Admin API. Methods return a
customized [report of data access records](https://developers.google.com/analytics/devguides/config/admin/v1/access-api).

## **2023-02-24** Added Expanded Data Sets management methods.

The [`ExpandedDataSet`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.expandedDataSets#ExpandedDataSet)
resource has been added to the *v1alpha* version of the API, along with the corresponding [`properties.expandedDataSets.create`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.expandedDataSets/create),
[`properties.expandedDataSets.delete`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.expandedDataSets/delete),
[`properties.expandedDataSets.patch`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.expandedDataSets/patch),
[`properties.expandedDataSets.list`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.expandedDataSets/list),
[`properties.expandedDataSets.get`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.expandedDataSets/get)
operations. This functionality can be used for managing [Expanded Data Sets](https://support.google.com/analytics/answer/12867885?ref_topic=13209062) in Google Analytics 360.

## **2023-02-24** Access Bindings are replacing User Links for user permissions management.

The [`AccessBinding`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts.accessBindings#AccessBinding)
resource has been added to the *v1alpha* version of the API, along with the
following operations:

- [`accounts.accessBindings.create`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts.accessBindings/create)
- [`accounts.accessBindings.delete`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts.accessBindings/delete)
- [`accounts.accessBindings.patch`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts.accessBindings/patch)
- [`accounts.accessBindings.list`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts.accessBindings/list)
- [`accounts.accessBindings.get`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts.accessBindings/get)
- [`accounts.accessBindings.batchCreate`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts.accessBindings/batchCreate)
- [`accounts.accessBindings.batchDelete`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts.accessBindings/batchDelete)
- [`accounts.accessBindings.batchUpdate`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts.accessBindings/batchUpdate)
- [`accounts.accessBindings.batchGet`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts.accessBindings/batchGet)
- [`properties.accessBindings.create`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.accessBindings/create)
- [`properties.accessBindings.delete`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.accessBindings/delete)
- [`properties.accessBindings.patch`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.accessBindings/patch)
- [`properties.accessBindings.list`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.accessBindings/list)
- [`properties.accessBindings.get`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.accessBindings/get)
- [`properties.accessBindings.batchCreate`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.accessBindings/batchCreate)
- [`properties.accessBindings.batchDelete`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.accessBindings/batchDelete)
- [`properties.accessBindings.batchUpdate`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.accessBindings/batchUpdate)
- [`properties.accessBindings.batchGet`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.accessBindings/batchGet)

This functionality allows managing user permissions for a GA4 account or
property and should be used instead of [User Links](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.userLinks).

**[User Links](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.userLinks) functionality will be removed
from the Admin API v1 alpha on 6/1/23**

### **2023-02-24** Deprecation of the user permissions audit methods.

The following methods are deprecated and will be removed from the Admin API v1
alpha on 6/1/23:

- [`accounts.userLinks.audit`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts.userLinks/audit)
- [`properties.userLinks.audit`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.userLinks/audit)

## **2023-02-24** Added Audience management methods.

The [`Audience`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.audiences#Audience)
resource has been added to the *v1alpha* version of the API, along with the
corresponding
[`properties.audience.create`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.audiences/create),
[`properties.audience.archive`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.audiences/archive),
[`properties.audience.patch`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.audiences/patch),
[`properties.audience.list`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.audiences/list),
[`properties.audience.get`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.audiences/get)
operations.

This functionality allows managing [audiences](https://support.google.com/analytics/answer/12799087) for a GA4 property.

## **2023-02-15** Added automated GA4 setup process opt-out methods.

[`properties.setAutomatedGa4ConfigurationOptOut`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/setAutomatedGa4ConfigurationOptOut),
[`properties.fetchAutomatedGa4ConfigurationOptOut`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/fetchAutomatedGa4ConfigurationOptOut) operations have been added to the *v1alpha* version of the API.

This functionality allows managing the [opt out status for the automated GA4
setup process](https://support.google.com/analytics/answer/12938611?ref_topic=10737980#optout)
for a UA property.

## **2023-02-15** Added BigQuery links management methods.

The [`BigQueryLink`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.bigQueryLinks#BigQueryLink)
resource has been added to the *v1alpha* version of the API, along with the
corresponding [`properties.bigQueryLinks.get`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.bigQueryLinks/get),
[`properties.bigQueryLinks.list`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.bigQueryLinks/list)
operations.

This functionality allows retrieving information about
[links between a GA4 Property and a BigQuery project](https://support.google.com/analytics/answer/9823238).

## **2023-02-15** Added Search Ads 360 links management methods.

The [`SearchAds360Link`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.searchAds360Links#SearchAds360Link)
resource has been added to the *v1alpha* version of the API, along with the corresponding [`properties.searchAds360Links.create`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.searchAds360Links/create),
[`properties.searchAds360Links.delete`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.searchAds360Links/delete),
[`properties.searchAds360Links.patch`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.searchAds360Links/patch),
[`properties.searchAds360Links.list`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.searchAds360Links/list),
[`properties.searchAds360Links.get`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.searchAds360Links/get)
operations.

This functionality allows managing links between a GA4 property and
a Search Ads 360 entity.

## **2023-02-15** Breaking changes.

- `LESS_THAN_OR_EQUAL`, `GREATER_THAN_OR_EQUAL` values removed from the
  [`NumericFilter.Operation`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.audiences#NumericFilter)
  enum.

- `PARTIAL_REGEXP` value removed from the [`StringFilter.MatchType`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.audiences#StringFilter)
  enum.

## **2023-02-15** Miscellaneous changes.

- `tokensPerProjectPerHour` field added to the [`AccessQuota`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/RunAccessReportResponse#AccessQuota) type.
- `EXPANDED_DATA_SET`, `CHANNEL_GROUP` values added to the [`ChangeHistoryResourceType`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts/searchChangeHistoryEvents#changehistoryresourcetype) enum.
- `searchAds360Link`, `expandedDataSet`, `bigqueryLink` values added to [`ChangeHistoryResource`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts/searchChangeHistoryEvents#changehistoryresource).

## **2022-08-11** `runAccessReport` method added to Admin API v1alpha.

The [`properties.runAccessReport`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/runAccessReport)
method added to the *v1alpha* version of the Admin API. It returns a
customized report of data access records. The report provides records of each
time a user reads Google Analytics reporting data. Data Access Reports are
available to Administrators of Google Analytics 360 properties.

## **2022-07-11** Admin API v1beta version released.

The [v1beta version](https://developers.google.com/analytics/devguides/config/admin/v1/rest)
of the Google Analytics Admin API has been released.

Both Alpha and Beta channels of the API continue to be supported for the Admin
API. Beta channel contains a subset of the features available in Alpha which
are considered stable and not expected to undergo a significant change in the
future. New features will be added to Beta once they mature.

## **2021-10-12** EnhancedMeasurementSettings methods removed from the API.

- `properties.webDataStreams.getEnhancedMeasurementSettings`, `properties.webDataStreams.updateEnhancedMeasurementSettings` methods are removed from the API, but [Enhanced Measurement](https://support.google.com/analytics/answer/9216061) settings will again be modifiable via API soon.
- The `directRoles` field of the [`UserLink`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts.userLinks#UserLink) resource no longer supports `predefinedRoles/manage-users` role. The new `predefinedRoles/admin` role should be used instead, which is equivalent to the combination of the old `predefinedRoles/edit` and `predefinedRoles/manage-users` roles. This change affects the behavior of [`accounts.userLinks`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts.userLinks), [`properties.userLinks`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.userLinks) methods and is in line with the [Access and data-restriction management](https://support.google.com/analytics/answer/10851388) changes introduced in the Google Analytics.

## **2021-06-05** Features added.

The following features are added to the API:

- [`accounts.searchChangeHistoryEvents`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts/searchChangeHistoryEvents) method was added to the API. This method searches through all changes to an account or its children given the specified set of filters. Common causes would be updates made in the Google Analytics UI, changes from customer support, or automatic Google Analytics system changes.
- Measurement protocol secrets management methods added under [`properties.dataStreams.measurementProtocolSecrets`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.measurementProtocolSecrets):
  - [`create`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.measurementProtocolSecrets/create) Creates a measurement protocol secret.
  - [`delete`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.measurementProtocolSecrets/delete) Deletes target measurement protocol secret.
  - [`get`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.measurementProtocolSecrets/get) Lookup for a single measurement protocol secret.
  - [`list`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.measurementProtocolSecrets/list) Returns child measurement protocol secrets under the specified parent Property.
  - [`patch`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.dataStreams.measurementProtocolSecrets/patch) Updates a measurement protocol secret.
- Conversion events management methods added under [`properties.conversionEvents`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.conversionEvents):
  - [`create`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.conversionEvents/create) Creates a conversion event with the specified attributes.
  - [`delete`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.conversionEvents/delete) Deletes a conversion event in a property.
  - [`get`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.conversionEvents/get) Retrieve a single conversion event.
  - [`list`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.conversionEvents/list) Returns a list of conversion events in the specified parent property.
- Custom dimensions management methods added under [`properties.customDimensions`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customDimensions):
  - [`archive`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customDimensions/archive) Archives a custom dimension on a property.
  - [`create`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customDimensions/create) Creates a custom dimension.
  - [`get`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customDimensions/get) Lookup for a single custom dimension.
  - [`list`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customDimensions/list) Lists custom dimensions on a property.
  - [`patch`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customDimensions/patch) Updates a custom dimension on a property.
- Custom metrics management methods added under [`properties.customMetrics`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customMetrics):
  - [`archive`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customMetrics/archive) Archives a custom metric on a property.
  - [`create`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customMetrics/create) reates a custom metric.
  - [`get`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customMetrics/get) Lookup for a single custom metric.
  - [`list`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customMetrics/list) Lists custom metrics on a property.
  - [`patch`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties.customMetrics/patch) Updates a custom metric on a property.
- Added [`properties.getGoogleSignalsSettings`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/getGoogleSignalsSettings), [`properties.updateGoogleSignalsSettings`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/updateGoogleSignalsSettings) methods that allow to control the [Google Signals](https://support.google.com/analytics/answer/9445345/ga4-activate-google-signals-for-google-analytics-4-properties) setting for a Google Analytics 4 property.
- [`delete_time`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties#Property.FIELDS.delete_time), [`expire_time`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties#Property.FIELDS.expire_time) output only fields added to the [`Property`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties#Property) type.

## **2021-06-05** Breaking changes.

The following breaking changes were introduced:

- `properties.iosAppDataStreams.create`, `properties.androidAppDataStreams.create` methods were removed from the API. Please use Firebase to create application streams in a Google Analytics 4 property.
- [`properties.delete`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties/delete) method now returns the deleted property data as [`Property`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties#Property) type instead of returning an empty response.
- [`time_zone`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties#Property.FIELDS.time_zone) field of the [`Property`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties#Property) type is now required.
- `deleted` field removed from the [`Property`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/properties#Property) type.
- [`email_address`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts.userLinks#UserLink.FIELDS.email_address) field of the [`UserLink`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts.userLinks#UserLink) type is now immutable.
- [`name`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts.userLinks#UserLink.FIELDS.name) field of the [`UserLink`](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts.userLinks#UserLink) type is now output only.

## **2021-01-28** Pagination support added for `ListFirebaseLinks` operation.

## **2021-01-28** Breaking changes.

Breaking changes:
- `update_mask` field is required for all Update operations.

- `country_code` field renamed to `region_code` in `Account`.

- `url_query_parameter` field renamed to `uri_query_parameter` in `EnhancedMeasurementSettings`.

- `parent` field removed from `GoogleAdsLink`.

## **2020-10-20** Added support for account summaries.

Added support for [account summaries](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accountSummaries/list) method.

## **2020-10-13** App + Web properties renamed to Google Analytics 4 (GA4).

## **2020-08-15** Management App + Web API renamed to Admin API.

Google Analytics Management App + Web API has been renamed to
the Google Analytics Admin API. As a result, the API endpoint has changed to
analyticsadmin.googleapis.com. Existing code written against the previous version
of the API endpoint url and client libraries needs to be updated accordingly.