Merchant Accounts API release notes

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 level from the relationship 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 bundle 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 merchant 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 bundle (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