Stay organized with collections
Save and categorize content based on your preferences.
Merchant API code sample to get an account by alias.
Java
// Copyright 2025 Google LLC//// Licensed under the Apache License, Version 2.0 (the "License");// you may not use this file except in compliance with the License.// You may obtain a copy of the License at//// https://www.apache.org/licenses/LICENSE-2.0//// Unless required by applicable law or agreed to in writing, software// distributed under the License is distributed on an "AS IS" BASIS,// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.// See the License for the specific language governing permissions and// limitations under the License.packageshopping.merchant.samples.accounts.accounts.v1;importcom.google.api.gax.core.FixedCredentialsProvider;importcom.google.auth.oauth2.GoogleCredentials;importcom.google.shopping.merchant.accounts.v1.Account;importcom.google.shopping.merchant.accounts.v1.AccountName;importcom.google.shopping.merchant.accounts.v1.AccountsServiceClient;importcom.google.shopping.merchant.accounts.v1.AccountsServiceSettings;importcom.google.shopping.merchant.accounts.v1.GetAccountRequest;importshopping.merchant.samples.utils.Authenticator;/** This class demonstrates how to get a single Merchant Center account by its alias. */publicclassGetAccountByAliasSample{publicstaticvoidgetAccountByAlias(longproviderId,Stringalias)throwsException{// Obtains OAuth token based on the user's configuration.GoogleCredentialscredential=newAuthenticator().authenticate();// Creates service settings using the credentials retrieved above.AccountsServiceSettingsaccountsServiceSettings=AccountsServiceSettings.newBuilder().setCredentialsProvider(FixedCredentialsProvider.create(credential)).build();// Creates account name to identify account.// The name has the format: accounts/{providerId}~{alias}// This format can used whenever an account name is needed. For example it can also be used to// get the homepage of an account or approve, get or list its services etc.// For more information about aliases see// https://developers.google.com/merchant/api/guides/accounts/relationshipsStringname=AccountName.newBuilder().setAccount(providerId+"~"+alias).build().toString();// Calls the API and catches and prints any network failures/errors.try(AccountsServiceClientaccountsServiceClient=AccountsServiceClient.create(accountsServiceSettings)){GetAccountRequestrequest=GetAccountRequest.newBuilder().setName(name).build();System.out.println("Sending Get Account request:");Accountresponse=accountsServiceClient.getAccount(request);System.out.println("Retrieved Account below");System.out.println(response);}catch(Exceptione){System.out.println(e);}}publicstaticvoidmain(String[]args)throwsException{// Update this with the provider ID of the account you want to get.longproviderId=123L;// Update this with the alias of the account you want to get.Stringalias="alias";getAccountByAlias(providerId,alias);}}
# -*- coding: utf-8 -*-# Copyright 2025 Google LLC## Licensed under the Apache License, Version 2.0 (the "License");# you may not use this file except in compliance with the License.# You may obtain a copy of the License at## http://www.apache.org/licenses/LICENSE-2.0## Unless required by applicable law or agreed to in writing, software# distributed under the License is distributed on an "AS IS" BASIS,# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.# See the License for the specific language governing permissions and# limitations under the License."""This class demonstrates how to get a single Merchant Center account by its alias."""fromexamples.authenticationimportgenerate_user_credentialsfromgoogle.shopping.merchant_accounts_v1importAccountsServiceClientfromgoogle.shopping.merchant_accounts_v1importGetAccountRequestdefget_account_by_alias(provider_id:int,alias:str)-> None:"""Gets a single Merchant Center account by its alias. Args: provider_id: The provider ID of the account. alias: The alias of the account. """# Gets OAuth Credentials.credentials=generate_user_credentials.main()# Creates a client.client=AccountsServiceClient(credentials=credentials)# Creates the name of the account to retrieve.# The name has the format: accounts/{providerId}~{alias}# This format can be used whenever an account name is needed. For example it# can also be used to get the homepage of an account or approve, get or list# its services etc.# For more information about aliases see# https://developers.google.com/merchant/api/guides/accounts/relationshipsname=f"accounts/{provider_id}~{alias}"# Creates the request.request=GetAccountRequest(name=name)# Makes the request and catches and prints any error messages.try:print("Sending Get Account request:")response=client.get_account(request=request)print("Retrieved Account below")print(response)exceptRuntimeErrorase:print(e)if__name__=="__main__":# Update this with the provider ID of the account you want to get.provider_id_=123# Update this with the alias of the account you want to get.alias_="alias"get_account_by_alias(provider_id_,alias_)
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-21 UTC."],[],[],null,["# Get an account by alias\n\nMerchant API code sample to get an account by alias. \n\n### Java\n\n // Copyright 2025 Google LLC\n //\n // Licensed under the Apache License, Version 2.0 (the \"License\");\n // you may not use this file except in compliance with the License.\n // You may obtain a copy of the License at\n //\n // https://www.apache.org/licenses/LICENSE-2.0\n //\n // Unless required by applicable law or agreed to in writing, software\n // distributed under the License is distributed on an \"AS IS\" BASIS,\n // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n // See the License for the specific language governing permissions and\n // limitations under the License.\n\n package shopping.merchant.samples.accounts.accounts.v1;\n\n import com.google.api.gax.core.FixedCredentialsProvider;\n import com.google.auth.oauth2.GoogleCredentials;\n import com.google.shopping.merchant.accounts.v1.Account;\n import com.google.shopping.merchant.accounts.v1.AccountName;\n import com.google.shopping.merchant.accounts.v1.AccountsServiceClient;\n import com.google.shopping.merchant.accounts.v1.AccountsServiceSettings;\n import com.google.shopping.merchant.accounts.v1.GetAccountRequest;\n import shopping.merchant.samples.utils.Authenticator;\n\n /** This class demonstrates how to get a single Merchant Center account by its alias. */\n public class GetAccountByAliasSample {\n\n public static void getAccountByAlias(long providerId, String alias) throws Exception {\n\n // Obtains OAuth token based on the user's configuration.\n GoogleCredentials credential = new Authenticator().authenticate();\n\n // Creates service settings using the credentials retrieved above.\n AccountsServiceSettings accountsServiceSettings =\n AccountsServiceSettings.newBuilder()\n .setCredentialsProvider(FixedCredentialsProvider.create(credential))\n .build();\n\n // Creates account name to identify account.\n // The name has the format: accounts/{providerId}~{alias}\n // This format can used whenever an account name is needed. For example it can also be used to\n // get the homepage of an account or approve, get or list its services etc.\n // For more information about aliases see\n // https://developers.google.com/merchant/api/guides/accounts/relationships\n String name = AccountName.newBuilder().setAccount(providerId + \"~\" + alias).build().toString();\n\n // Calls the API and catches and prints any network failures/errors.\n try (AccountsServiceClient accountsServiceClient =\n AccountsServiceClient.create(accountsServiceSettings)) {\n\n GetAccountRequest request = GetAccountRequest.newBuilder().setName(name).build();\n\n System.out.println(\"Sending Get Account request:\");\n Account response = accountsServiceClient.getAccount(request);\n\n System.out.println(\"Retrieved Account below\");\n System.out.println(response);\n } catch (Exception e) {\n System.out.println(e);\n }\n }\n\n public static void main(String[] args) throws Exception {\n // Update this with the provider ID of the account you want to get.\n long providerId = 123L;\n // Update this with the alias of the account you want to get.\n String alias = \"alias\";\n getAccountByAlias(providerId, alias);\n }\n } \n https://github.com/google/merchant-api-samples/blob/c6de994268c785ce22af0065932518a9ac5b3c03/java/src/main/java/shopping/merchant/samples/accounts/accounts/v1/GetAccountByAliasSample.java\n\n### Python\n\n # -*- coding: utf-8 -*-\n # Copyright 2025 Google LLC\n #\n # Licensed under the Apache License, Version 2.0 (the \"License\");\n # you may not use this file except in compliance with the License.\n # You may obtain a copy of the License at\n #\n # http://www.apache.org/licenses/LICENSE-2.0\n #\n # Unless required by applicable law or agreed to in writing, software\n # distributed under the License is distributed on an \"AS IS\" BASIS,\n # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n # See the License for the specific language governing permissions and\n # limitations under the License.\n \"\"\"This class demonstrates how to get a single Merchant Center account by its alias.\"\"\"\n\n from examples.authentication import generate_user_credentials\n from google.shopping.merchant_accounts_v1 import AccountsServiceClient\n from google.shopping.merchant_accounts_v1 import GetAccountRequest\n\n\n def get_account_by_alias(provider_id: int, alias: str) -\u003e None:\n \"\"\"Gets a single Merchant Center account by its alias.\n\n Args:\n provider_id: The provider ID of the account.\n alias: The alias of the account.\n \"\"\"\n\n # Gets OAuth Credentials.\n credentials = generate_user_credentials.main()\n\n # Creates a client.\n client = AccountsServiceClient(credentials=credentials)\n\n # Creates the name of the account to retrieve.\n # The name has the format: accounts/{providerId}~{alias}\n # This format can be used whenever an account name is needed. For example it\n # can also be used to get the homepage of an account or approve, get or list\n # its services etc.\n # For more information about aliases see\n # https://developers.google.com/merchant/api/guides/accounts/relationships\n name = f\"accounts/{provider_id}~{alias}\"\n\n # Creates the request.\n request = GetAccountRequest(name=name)\n\n # Makes the request and catches and prints any error messages.\n try:\n print(\"Sending Get Account request:\")\n response = client.get_account(request=request)\n print(\"Retrieved Account below\")\n print(response)\n except RuntimeError as e:\n print(e)\n\n\n if __name__ == \"__main__\":\n # Update this with the provider ID of the account you want to get.\n provider_id_ = 123\n # Update this with the alias of the account you want to get.\n alias_ = \"alias\"\n get_account_by_alias(provider_id_, alias_)\n\n https://github.com/google/merchant-api-samples/blob/c6de994268c785ce22af0065932518a9ac5b3c03/python/examples/accounts/accounts/v1/get_account_by_alias_sample.py"]]