AccountsService

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

Creates a Merchant Center account with additional configuration. Adds the user that makes the request as an admin for the new account.

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/content

For more information, see the OAuth 2.0 Overview.

rpc CreateTestAccount(CreateTestAccountRequest) returns (Account)

Creates a Merchant Center test account.

Test accounts are intended for development and testing purposes, such as validating API integrations or new feature behavior.

Key characteristics and limitations of test accounts:

• Immutable Type: A test account cannot be converted into a regular (live) Merchant Center account. Likewise, a regular account cannot be converted into a test account.

• Non-Serving Products: Any products, offers, or data created within a test account will not be published or made visible to end-users on any Google surfaces. They are strictly for testing environments.

• Separate Environment: Test accounts operate in a sandbox-like manner, isolated from live serving and real user traffic.

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/content

For more information, see the OAuth 2.0 Overview.

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

Deletes the specified account regardless of its type: standalone, advanced account or sub-account. Deleting an advanced account leads to the deletion of all of its sub-accounts. This also deletes the account's developer registration entity and any associated GCP project to the account. Executing this method requires admin access. The deletion succeeds only if the account does not provide services to any other account and has no processed offers. You can use the force parameter to override this.

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/content

For more information, see the OAuth 2.0 Overview.

rpc GetAccount(GetAccountRequest) returns (Account)

Retrieves an account from your Merchant Center account. After inserting, updating, or deleting an account, it may take several minutes before changes take effect.

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/content

For more information, see the OAuth 2.0 Overview.

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

Note: For the accounts.list method, quota and limits usage are charged for each user, and not for the Merchant Center ID or the advanced account ID. To list several sub-accounts, you should use the accounts.listSubaccounts method, which is more suitable for advanced accounts use case.

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/content

For more information, see the OAuth 2.0 Overview.

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

List all sub-accounts for a given advanced account. This is a convenience wrapper for the more powerful accounts.list method. This method will produce the same results as calling ListsAccounts with the following filter: relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/content

For more information, see the OAuth 2.0 Overview.

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

Updates an account regardless of its type: standalone, advanced account or sub-account. Executing this method requires admin access.

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/content

For more information, see the OAuth 2.0 Overview.