Merchant API code sample to update a homepage. ### Java // Copyright 2024 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.homepages.v1; import com.google.api.gax.core.FixedCredentialsProvider; import com.google.auth.oauth2.GoogleCredentials; import com.google.protobuf.FieldMask; import com.google.shopping.merchant.accounts.v1.Homepage; import com.google.shopping.merchant.accounts.v1.HomepageName; import com.google.shopping.merchant.accounts.v1.HomepageServiceClient; import com.google.shopping.merchant.accounts.v1.HomepageServiceSettings; import com.google.shopping.merchant.accounts.v1.UpdateHomepageRequest; import shopping.merchant.samples.utils.Authenticator; import shopping.merchant.samples.utils.Config; /** This class demonstrates how to update a homepage to a new URL. */ public class UpdateHomepageSample { public static void updateHomepage(Config config, String uri) throws Exception { GoogleCredentials credential = new Authenticator().authenticate(); HomepageServiceSettings homepageServiceSettings = HomepageServiceSettings.newBuilder() .setCredentialsProvider(FixedCredentialsProvider.create(credential)) .build(); // Creates homepage name to identify homepage. String name = HomepageName.newBuilder().setAccount(config.getAccountId().toString()).build().toString(); // Create a homepage with the updated fields. Homepage homepage = Homepage.newBuilder().setName(name).setUri(uri).build(); FieldMask fieldMask = FieldMask.newBuilder().addPaths("uri").build(); try (HomepageServiceClient homepageServiceClient = HomepageServiceClient.create(homepageServiceSettings)) { UpdateHomepageRequest request = UpdateHomepageRequest.newBuilder().setHomepage(homepage).setUpdateMask(fieldMask).build(); System.out.println("Sending Update Homepage request"); Homepage response = homepageServiceClient.updateHomepage(request); System.out.println("Updated Homepage Name below"); System.out.println(response.getName()); } catch (Exception e) { System.out.println(e); } } public static void main(String[] args) throws Exception { Config config = Config.load(); // The URI (a URL) of the store's homepage. String uri = "https://example.com"; updateHomepage(config, uri); } } ### PHP $credentials]; // Creates a client. $homepageServiceClient = new HomepageServiceClient($options); // Creates Homepage name to identify Homepage. // The name has the format: accounts/{account}/homepage $name = "accounts/" . $config['accountId'] . "/homepage"; // Create a homepage with the updated fields. $homepage = new Homepage(['name' => $name, 'uri' => $uri]); // Create field mask to specify which fields to update. $fieldMask = new FieldMask(['paths' => ['uri']]); try { $request = new UpdateHomepageRequest([ 'homepage' => $homepage, 'update_mask' => $fieldMask ]); print "Sending Update Homepage request\n"; $response = $homepageServiceClient->updateHomepage($request); print "Updated Homepage Name below\n"; print $response->getName() . "\n"; } catch (ApiException $e) { print $e->getMessage(); } } /** * Helper to execute the sample. * * @return void */ public function callSample(): void { $config = Config::generateConfig(); // The URI (a URL) of the store's homepage. $uri = "https://example.com"; // Makes the call to update the homepage. self::updateHomepageSample($config, $uri); } } // Run the script $sample = new UpdateHomepage(); $sample->callSample(); ### Python # -*- coding: utf-8 -*- # Copyright 2024 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. """A module to update a Homepage.""" from examples.authentication import configuration from examples.authentication import generate_user_credentials from google.protobuf import field_mask_pb2 from google.shopping.merchant_accounts_v1 import Homepage from google.shopping.merchant_accounts_v1 import HomepageServiceClient from google.shopping.merchant_accounts_v1 import UpdateHomepageRequest _ACCOUNT = configuration.Configuration().read_merchant_info() def update_homepage(new_uri): """Updates a homepage to a new URL.""" # Gets OAuth Credentials. credentials = generate_user_credentials.main() # Creates a client. client = HomepageServiceClient(credentials=credentials) # Creates Homepage name to identify Homepage. name = "accounts/" + _ACCOUNT + "/homepage" # Create a homepage with the updated fields. homepage = Homepage(name=name, uri=new_uri) # Create a FieldMask for the "uri" field. field_mask = field_mask_pb2.FieldMask(paths=["uri"]) # Creates the request. request = UpdateHomepageRequest(homepage=homepage, update_mask=field_mask) # Makes the request and catches and prints any error messages. try: response = client.update_homepage(request=request) print("Updated Homepage Name below") print(response.name) except RuntimeError as e: print(e) if __name__ == "__main__": # The URI (a URL) of the store's homepage. uri = "https://example.com" update_homepage(uri)