## Week of October 26, 2026

- Clarified the documentation for the [`accounts.homepage.unclaim`](https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.homepage/unclaim.md.txt) method and the `claimed` field of the [`Homepage`](https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.homepage.md.txt#Homepage) resource. If an account inherits its homepage claim from its advanced account, `unclaim` returns a successful response, but the homepage stays claimed. If the account itself is exempted from claiming, `unclaim` returns a `FAILED_PRECONDITION` error.

## Week of September 28, 2026

- Added `youtube_affiliate_management` as a service type to the
  `AccountService` resource in `v1alpha`. Note: YouTube Affiliate Management
  is a feature with limited access.

- Alpha launch of `LoyaltyPrograms` service that you can use to manage loyalty
  programs. This feature is only available to selected merchants. For more
  information, see the
  [Overview of loyalty programs](https://developers.google.com/merchant/api/guides/loyalty/loyalty-programs.md.txt).

- Added the read-only `home_page_uri` field to the
  [`accounts`](https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.md.txt) resource to
  return the URI of the store's homepage.

## Week of August 3, 2026

- Added 'ucp_checkout_management' as a service type to the account service resource. Note: UCP checkout is a feature with limited access.
- Added support for 'ucp-integration' program (limited access).
- Added support for 'ucp_integration' terms of service kind.

## Week of June 29, 2026

- Launch of the `access` filter used in the [accounts list end point](https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts/list.md.txt). This feature lets you filter accounts based on your access level, with possible values being `DIRECT`, `INDIRECT`, and `ALL`. The default behavior is to return all accounts you have access to. For more information, see [Filter accounts you can access](https://developers.google.com/merchant/api/guides/accounts/filter.md.txt).

## Week of April 20, 2026

- Added `youtube-affiliate` to the list of available program names to [`accounts.programs`](https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.programs.md.txt) resource description.
- Enable program API for YouTube Shopping Affiliate. Available to trusted testers.

## Week of Apr 6, 2026

- Added the `WAITING` state to Approval State. For Comparison Shopping Services (CSS), `WAITING` is a transitional state between `PENDING` and `ESTABLISHED`. Used when the original CSS requires time to perform any necessary cleanup before the account is fully transferred to the new CSS.

## Week of Mar 16, 2026

- Launched the `CreateTestAccount` method in the Accounts API. This lets developers programmatically create dedicated test accounts that operate in an isolated sandbox-like environment, providing a safe space to develop and test integrations.

## Week of Nov 17, 2025

- `CreateAndConfigureAccountRequest` now offers new services that can be
  configured during account set-up. Exactly one of `AccountAggregation`,
  `AccountManagement` and `ComparisonShopping` must be specified. Additionaly
  it is possible to specify an arbitrary number of `ProductsManagement` and
  `CampaignsManagement` services. There must be, however, no two such services
  that have the same provider and external account IDs.

- The `AccountsService.CreateAndConfigure` method now provides a setting to
  control whether a verification email should be sent.

- `CreateAndConfigureAccountRequest.AddAccountService` now has an
  `external_account_id` field (this field already exists on
  the `AccountService`)
  resource. It can be specified together with `CampaignsManagement` and
  `ProductsManagement` services.

- Added a `ComparisonShopping` service to the `AccountService` resource. See
  https://support.google.com/merchants/answer/12653197 for more details.

- It is now possible to set an alias for a relationship during account creation
  using the `setAlias` field in `CreateAndConfigureAccountRequest`.

- Added a `VerifySelf` method to the `UserService` that allows the update the
  state from `PENDING` to `VERIFIED` for the `User` resource representing the
  user making the call.

- Launch the new `radius_area` field in the `Region` payload of the Regions API
  that will allow merchants to create region using radius area.

## Week of Nov 10, 2025

- Publish the v1alpha version for the Services API.
- Launch the new `product_filters` field in the `CampaignManagement` payload of the Services API that will allow merchants to share only a subset of their feed with Google Ads accounts, based on some conditional filtering on the attributes of the merchant's products. This is an allowlisted feature only accessible to a limited amount of merchants.

## Week of Aug 25, 2025

- New batch methods added to the Regions API:
  - `BatchCreateRegions`: Allows creating multiple regions in a single request.
  - `BatchUpdateRegions`: Enables updating multiple regions in a single request.
  - `BatchDeleteRegions`: Provides the ability to delete multiple regions by name in a single request.

## Week of Jul 1, 2025

- Launch of CheckoutSettings resource which allow API users to create, update, delete, get checkoutSettings.

## Week of May 26, 2025

- It is now possible to filter accounts by `capabilities`. At the moment the
  only possible value is `CAN_UPLOAD_PRODUCTS`. This filter lets you retrieve
  accounts that are capable of uploading products. This means the following
  clauses can now used at the account level:

  - `capabilities:CAN_UPLOAD_PRODUCTS`
  - `-capabilities:CAN_UPLOAD_PRODUCTS`
  - `NOT capabilities:CAN_UPLOAD_PRODUCTS` For more information, see [filtering guide](https://developers.google.com/merchant/api/guides/accounts/filter.md.txt).
- Launch of the read-only access right. Users with the read-only access right
  can view merchant data, but can't modify it.

## Week of May 19, 2025

- Updated documentation for program API, removing incorrect statement that `Enable`/`Disable` methods are restricted to admin users.

## Week of May 12, 2025

- Launch of Online Return Policy resource which allow API users to create, update, and delete return policies.
- Launch of OmnichannelSettingsService and OmnichannelSetting resource which allows API users to manage their omnichannel experience.
- Launch of LfpProvidersService and LfpProvider resource which allows API users to manage their Local Feeds Partnership relationship.
- Launch of GbpAccountsService and GbpAccount resource which allows API users to manage their Google Business Profile.
- Launch service type LocalListingManagement in AccountService, which links business group which is used for Local Inventory Ads or Free Local Listings.

## Week of Apr 28, 2025

- Launch of AccountService and AccountRelationship resources which allow API users to manage relationships and establish services to service providers.

## Week of Apr 14, 2025

- `TermsOfServiceService.AcceptTermsOfService` now returns the
  `TermsOfServiceAgremeentState` that was accepted wrapped in a response type.

- The verb of the `TermsOfServiceService.AcceptTermsOfService` action is now
  `POST` (used to be `GET`).

- Clarified that `AccountsService.ListSubAccounts` needs to be called using the
  `accounts/...` format (rather than `providers/...`). This is to avoid having
  this method falling out of the `accounts` scope (that means
  `GET accounts/123:listSubAccounts` rather than
  `GET providers/123:listSubAccounts`).

## Week of Mar 31, 2025

- For filtering accounts, the `externalAccountId` filter was announced
  deprecated in the week of Dec 2, 2024 and is now unavailable. This means that
  filtering by `externalAccountId` is now only possible on the `service` level.
  A
  filter such as `relationship(externalAccountId = "foo")` will no longer work
  and
  needs to be expressed as `relationship(service(externalAccountId = "foo"))`.

- Clarified in `AccountsService` documentation that one can't create standalone
  accounts.

## Week of Mar 3, 2025

-The [`accounts.onlineReturnPolicies#SeasonalOverride`](https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.onlineReturnPolicies.md.txt#SeasonalOverride)
has been refactored to improve clarity and consistency. These updates include:

- **Field Renaming:**
  - `begin` is now `start_date`.
  - `end` is now `end_date`.
- **Field Removal:**
  - The deprecated `policy` field has been removed.

-Developers should update their code to reflect these changes.

Launch of `AutomaticImprovements` service that you can use to manage the
following:

- [Item updates](https://support.google.com/merchants/answer/12157888)
- [Image improvements](https://support.google.com/merchants/answer/12724659)
- [Shipping improvements](https://support.google.com/merchants/answer/10027038)

For more information,
see [Enable automatic improvements](https://developers.google.com/merchant/api/guides/automatic-improvements/overview.md.txt).

## Week of Feb 17, 2025

Removed the `callerHasAccessToProviderFilter()` predicate from the account
filter.

## Week of Feb 10, 2025

- Improved documentation for the `AccountsService.List` method. It returns all
  the accounts the user has access to, not just standalone accounts.

- Added default deadline of 10 minutes for all RPC methods.

- Added the list of available program names to
  [`accounts.programs`](https://developers.google.com/merchant/api/reference/rest/accounts_v1/accounts.programs.md.txt)
  resource description.

- `User.accessRights` is now `REQUIRED` affecting both the `UserService.Create`
  and `AccountsService.CreateAndConfigure` methods.

## Week of Jan 27, 2025

`AccountsService.ListAccounts` (and transitively
`AccountsService.ListSubAccounts`) now return accounts in an eventual consistent
manner rather than being a strong read.

## Week of Jan 20, 2025

The `users` field of the `CreateAndConfigureAccountRequest` is deprecated in
favor of a new `user`. The `CreateUserRequest` that was referenced contains
the `parent` field that is not required in the context of the
`CreateAndConfigureAccountRequest`.

## Week of Jan 6, 2025

The `user` field of the `CreateUserRequest` message is now correctly marked as
`OPTIONAL`.

The `domain` field in returned errors is now populated with
`merchantapi.googleapis.com` instead of `global`

## Week of Dec 2, 2024

For filtering accounts, the `externalAccountId` predicate is moved to the
[`service`](https://developers.google.com/merchant/api/guides/accounts/filter.md.txt#service_filters)
level from the
[`relationship`](https://developers.google.com/merchant/api/guides/accounts/filter.md.txt#relationship_filters)
level. So, a filter `relationship(externalAccountId = "foo")` would now need to
be written as `relationship(service(externalAccountId = "foo"))`. The old format
is still supported for backwards compatibility, but is deprecated and will throw
an error in the near future. All documentation will only mention the new format.

## Week of Nov 18, 2024

The provider in the `CreateAndConfigureAccountRequest.service.provider` field
may now also be one of `providers/GOOGLE_ADS` or
`providers/GOOGLE_BUSINESS_PROFILE`. Other accounts should be referred to as
`providers/123` (rather than `accounts/123`). This means that the field is no
longer annotated as an account reference. However, it is still also possible to
use account names such as `accounts/123` for backwards compatibility.

The provider in the `ListSubAccountsRequest` should now be of the form
`providers/123`, but for backwards compatibility it will still be possible to
use `accounts/123`.

## Week of Nov 4, 2024

Mark `promotions_consent` `REQUIRED` (from `OPTIONAL`) in `BusinessIdentity`
resource. This affects the update method only. This is to clarify that it is not
possible to update `promotions_consent` to `UNSPECIFIED`. This was already not
possible, but the error is now more descriptive and the field is correctly
annotated.

## Week of Oct 28, 2024

Improve documentation of various resources of the Accounts sub-API such as
`User`, `Homepage`, `BusinessInfo` and so on.

## Week of Oct 21, 2024

Improve documentation of `update_mask` fields in update requests throughout to
specifically point out which fields are supported for update.

Added google business help center link for supported carriers to the external
doc of `ShippingSettings` resource

## Week of Oct 14, 2024

Mark `provider` as `REQUIRED` in
`AccountsService.CreateAndConfigureAccountRequest.AddAccountService`.

Make `update_mask` optional throughout Accounts sub-API (e.g. business identity,
business information, homepage etc.) and retroactively for the
`ConversionSources` resource.

Added `overwrite` parameter to `ClaimHomepageRequest`.

## Week of Sep 30, 2024

Launch of 'force' parameter for 'Accounts.delete' method.

## Week of Sep 23, 2024

Mark `region_code` and `kind` as `REQUIRED` in
`RetrieveLatestTermsOfServiceRequest`.

## Week of Sep 16, 2024

Changed the type of `time_zone` parameter to string in the
`ListAccountIssuesRequest`

## Week of Aug 12, 2024

Added `korean_business_registration_number` field to the `BusinessInfo`
resource.

## Week of May 27, 2024

Beta launch of Accounts sub-API