List GBP accounts

Merchant API code sample to list GBP accounts.

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. 
 package 
  
 shopping.merchant.samples.accounts.gbpaccounts.v1 
 ; 
 import 
  
 com.google.api.gax.core.FixedCredentialsProvider 
 ; 
 import 
  
 com.google.auth.oauth2.GoogleCredentials 
 ; 
 import 
  
 com.google.shopping.merchant.accounts.v1.AccountName 
 ; 
 import 
  
 com.google.shopping.merchant.accounts.v1.GbpAccount 
 ; 
 import 
  
 com.google.shopping.merchant.accounts.v1.GbpAccountsServiceClient 
 ; 
 import 
  
 com.google.shopping.merchant.accounts.v1.GbpAccountsServiceClient.ListGbpAccountsPagedResponse 
 ; 
 import 
  
 com.google.shopping.merchant.accounts.v1.GbpAccountsServiceSettings 
 ; 
 import 
  
 com.google.shopping.merchant.accounts.v1.ListGbpAccountsRequest 
 ; 
 import 
  
 shopping.merchant.samples.utils.Authenticator 
 ; 
 import 
  
 shopping.merchant.samples.utils.Config 
 ; 
 /** 
 * This class demonstrates how to get the list of GBP accounts for a given Merchant Center account 
 */ 
 public 
  
 class 
 ListGbpAccountsSample 
  
 { 
  
 public 
  
 static 
  
 void 
  
 listGbpAccounts 
 ( 
 Config 
  
 config 
 ) 
  
 throws 
  
 Exception 
  
 { 
  
 // Obtains OAuth token based on the user's configuration. 
  
 GoogleCredentials 
  
 credential 
  
 = 
  
 new 
  
 Authenticator 
 (). 
 authenticate 
 (); 
  
 // Creates service settings using the credentials retrieved above. 
  
 GbpAccountsServiceSettings 
  
 gbpAccountsServiceSettings 
  
 = 
  
 GbpAccountsServiceSettings 
 . 
 newBuilder 
 () 
  
 . 
 setCredentialsProvider 
 ( 
 FixedCredentialsProvider 
 . 
 create 
 ( 
 credential 
 )) 
  
 . 
 build 
 (); 
  
 String 
  
 accountId 
  
 = 
  
 config 
 . 
 getAccountId 
 (). 
 toString 
 (); 
  
 // Creates parent to identify the omnichannelSetting from which to list all Lfp Providers. 
  
 String 
  
 parent 
  
 = 
  
 AccountName 
 . 
 newBuilder 
 (). 
 setAccount 
 ( 
 accountId 
 ). 
 build 
 (). 
 toString 
 (); 
  
 // Calls the API and catches and prints any network failures/errors. 
  
 try 
  
 ( 
 GbpAccountsServiceClient 
  
 gbpAccountsServiceClient 
  
 = 
  
 GbpAccountsServiceClient 
 . 
 create 
 ( 
 gbpAccountsServiceSettings 
 )) 
  
 { 
  
 ListGbpAccountsRequest 
  
 request 
  
 = 
  
 ListGbpAccountsRequest 
 . 
 newBuilder 
 (). 
 setParent 
 ( 
 parent 
 ). 
 build 
 (); 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 "Sending list GBP accounts request:" 
 ); 
  
 ListGbpAccountsPagedResponse 
  
 response 
  
 = 
  
 gbpAccountsServiceClient 
 . 
 listGbpAccounts 
 ( 
 request 
 ); 
  
 int 
  
 count 
  
 = 
  
 0 
 ; 
  
 // Iterates over all the entries in the response. 
  
 for 
  
 ( 
 GbpAccount 
  
 gbpAccount 
  
 : 
  
 response 
 . 
 iterateAll 
 ()) 
  
 { 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 gbpAccount 
 ); 
  
 count 
 ++ 
 ; 
  
 } 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 String 
 . 
 format 
 ( 
 "The following count of elements were returned: %d" 
 , 
  
 count 
 )); 
  
 } 
  
 catch 
  
 ( 
 Exception 
  
 e 
 ) 
  
 { 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 "An error has occured: " 
 ); 
  
 System 
 . 
 out 
 . 
 println 
 ( 
 e 
 ); 
  
 } 
  
 } 
  
 public 
  
 static 
  
 void 
  
 main 
 ( 
 String 
 [] 
  
 args 
 ) 
  
 throws 
  
 Exception 
  
 { 
  
 Config 
  
 config 
  
 = 
  
 Config 
 . 
 load 
 (); 
  
 listGbpAccounts 
 ( 
 config 
 ); 
  
 } 
 } 
  
 

PHP

 < ?php 
 /** 
 * 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. 
 */ 
 require_once __DIR__ . '/../../../../vendor/autoload.php'; 
 require_once __DIR__ . '/../../../Authentication/Authentication.php'; 
 require_once __DIR__ . '/../../../Authentication/Config.php'; 
 use Google\ApiCore\ApiException; 
 use Google\Shopping\Merchant\Accounts\V1\Client\GbpAccountsServiceClient; 
 use Google\Shopping\Merchant\Accounts\V1\GbpAccount; 
 use Google\Shopping\Merchant\Accounts\V1\ListGbpAccountsRequest; 
 /** 
 * This class demonstrates how to get the list of GBP accounts for a given 
 * Merchant Center account. 
 */ 
 class ListGbpAccountsSample 
 { 
 /** 
 * A helper function to create the parent string. 
 * 
 * @param string $accountId The account ID. 
 * 
 * @return string The parent has the format: `accounts/{account_id}` 
 */ 
 private static function getParent(string $accountId): string 
 { 
 return sprintf('accounts/%s', $accountId); 
 } 
 /** 
 * Retrieves the list of GBP accounts for a given Merchant Center account. 
 * 
 * @param array $config The configuration data for authentication and account ID. 
 * 
 * @return void 
 */ 
 public static function listGbpAccounts(array $config): void 
 { 
 // Gets the OAuth credentials to make the request. 
 $credentials = Authentication::useServiceAccountOrTokenFile(); 
 // Creates options config containing credentials for the client to use. 
 $options = ['credentials' => $credentials]; 
 // Creates a client. 
 $gbpAccountsServiceClient = new GbpAccountsServiceClient($options); 
 // Creates the parent account name to identify the merchant. 
 $parent = self::getParent($config['accountId']); 
 // Creates the request to list GBP accounts. 
 $request = new ListGbpAccountsRequest([ 
 'parent' => $parent 
 ]); 
 // Calls the API and catches and prints any network failures/errors. 
 try { 
 printf("Sending list GBP accounts request:%s", PHP_EOL); 
 $response = $gbpAccountsServiceClient->listGbpAccounts($request); 
 $count = 0; 
 // Iterates over all the GBP accounts in the response and prints them. 
 foreach ($response->iterateAllElements() as $gbpAccount) { 
 /** @var GbpAccount $gbpAccount */ 
 print_r($gbpAccount->serializeToJsonString()); 
 $count++; 
 } 
 printf( 
 "The following count of elements were returned: %d%s", 
 $count, 
 PHP_EOL 
 ); 
 } catch (ApiException $e) { 
 printf("An error has occurred: %s%s", $e->getMessage(), PHP_EOL); 
 } 
 } 
 /** 
 * Helper to execute the sample. 
 * 
 * @return void 
 */ 
 public function callSample(): void 
 { 
 $config = Config::generateConfig(); 
 self::listGbpAccounts($config); 
 } 
 } 
 // Runs the script. 
 $sample = new ListGbpAccountsSample(); 
 $sample->callSample();  
 
 

Python

  # -*- 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. 
 """Demonstrates how to get the list of GBP accounts for a given Merchant Center account.""" 
 from 
  
 examples.authentication 
  
 import 
 configuration 
 from 
  
 examples.authentication 
  
 import 
 generate_user_credentials 
 from 
  
 google.shopping.merchant_accounts_v1 
  
 import 
 GbpAccountsServiceClient 
 from 
  
 google.shopping.merchant_accounts_v1 
  
 import 
 ListGbpAccountsRequest 
 # Gets the merchant account ID from the configuration file. 
 _ACCOUNT 
 = 
 configuration 
 . 
 Configuration 
 () 
 . 
 read_merchant_info 
 () 
 # Creates the parent resource name string. 
 _PARENT 
 = 
 f 
 "accounts/ 
 { 
 _ACCOUNT 
 } 
 " 
 def 
  
 list_gbp_accounts 
 () 
 - 
> None 
 : 
  
 """Lists the Google Business Profile accounts for a given Merchant Center account.""" 
 # Gets OAuth Credentials. 
 credentials 
 = 
 generate_user_credentials 
 . 
 main 
 () 
 # Creates a client. 
 client 
 = 
 GbpAccountsServiceClient 
 ( 
 credentials 
 = 
 credentials 
 ) 
 # Creates the request. 
 request 
 = 
 ListGbpAccountsRequest 
 ( 
 parent 
 = 
 _PARENT 
 ) 
 # Makes the request and catches and prints any error messages. 
 try 
 : 
 print 
 ( 
 "Sending list GBP accounts request:" 
 ) 
 # Makes the request and retrieves the list of GBP accounts. 
 response 
 = 
 client 
 . 
 list_gbp_accounts 
 ( 
 request 
 = 
 request 
 ) 
 count 
 = 
 0 
 # Iterates over all the GBP accounts in the response and prints them. 
 for 
 gbp_account 
 in 
 response 
 : 
 print 
 ( 
 gbp_account 
 ) 
 count 
 += 
 1 
 print 
 ( 
 f 
 "The following count of elements were returned: 
 { 
 count 
 } 
 " 
 ) 
 except 
 RuntimeError 
 as 
 e 
 : 
 print 
 ( 
 "An error has occured: " 
 ) 
 print 
 ( 
 e 
 ) 
 if 
 __name__ 
 == 
 "__main__" 
 : 
 list_gbp_accounts 
 () 
  
 
Design a Mobile Site
View Site in Mobile | Classic
Share by: