-
Notifications
You must be signed in to change notification settings - Fork 484
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Changes for release v6_0 and deprecation of v2_0. (#335)
- Loading branch information
Showing
2,943 changed files
with
205,156 additions
and
170,682 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
170 changes: 170 additions & 0 deletions
170
examples/account_management/reject_merchant_center_link.py
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,170 @@ | ||
| #!/usr/bin/env python | ||
| # Copyright 2020 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. | ||
| """Demonstrates how to reject or unlink a Merchant Center link request. | ||
| Prerequisite: You need to have access to a Merchant Center account. You can find | ||
| instructions to create a Merchant Center account here: | ||
| https://support.google.com/merchants/answer/188924. | ||
| To run this example, you must use the Merchant Center UI or the Content API for | ||
| Shopping to send a link request between your Merchant Center and Google Ads | ||
| accounts. You can find detailed instructions to link your Merchant Center and | ||
| Google Ads accounts here: https://support.google.com/merchants/answer/6159060. | ||
| """ | ||
|
|
||
| import argparse | ||
| import sys | ||
|
|
||
| from google.ads.google_ads.client import GoogleAdsClient | ||
| from google.ads.google_ads.errors import GoogleAdsException | ||
|
|
||
|
|
||
| def main(client, customer_id, merchant_center_account_id): | ||
| """Demonstrates how to reject a Merchant Center link request. | ||
| Args: | ||
| client: An initialized Google Ads client. | ||
| customer_id: The Google Ads customer ID. | ||
| merchant_center_account_id: The Merchant Center account ID for the | ||
| account requesting to link. | ||
| """ | ||
| # Get the MerchantCenterLinkService client. | ||
| merchant_center_link_service = client.get_service( | ||
| "MerchantCenterLinkService", version="v6" | ||
| ) | ||
| try: | ||
| # Get the extant customer account to Merchant Center account links. | ||
| list_merchant_center_links_response = merchant_center_link_service.list_merchant_center_links( | ||
| customer_id | ||
| ) | ||
|
|
||
| number_of_links = len( | ||
| list_merchant_center_links_response.merchant_center_links | ||
| ) | ||
|
|
||
| if number_of_links <= 0: | ||
| print( | ||
| "There are no current merchant center links to Google Ads " | ||
| f"account {customer_id}. This example will now exit." | ||
| ) | ||
| return | ||
|
|
||
| print( | ||
| f"{number_of_links} Merchant Center link(s) found with the " | ||
| "following details:" | ||
| ) | ||
|
|
||
| merchant_center_link_status_enum = client.get_type( | ||
| "MerchantCenterLinkStatusEnum", version="v6" | ||
| ).MerchantCenterLinkStatus | ||
|
|
||
| for merchant_center_link in list_merchant_center_links_response.merchant_center_links: | ||
| print( | ||
| f"\tLink '{merchant_center_link.resource_name}' has status " | ||
| f"'{merchant_center_link_status_enum.Name(merchant_center_link.status)}'." | ||
| ) | ||
|
|
||
| # Check if this is the link to the target Merchant Center account. | ||
| if merchant_center_link.id == merchant_center_account_id: | ||
| # A Merchant Center link can be pending or enabled; in both | ||
| # cases, we reject it by removing the link. | ||
| _remove_merchant_center_link( | ||
| client, | ||
| merchant_center_link_service, | ||
| customer_id, | ||
| merchant_center_link, | ||
| ) | ||
|
|
||
| # We can terminate early since this example concerns only one | ||
| # Google Ads account to Merchant Center account link. | ||
| return | ||
|
|
||
| # Raise an exception if no matching Merchant Center link was found. | ||
| raise ValueError( | ||
| "No link could was found between Google Ads account " | ||
| f"{customer_id} and Merchant Center account " | ||
| f"{merchant_center_account_id}." | ||
| ) | ||
|
|
||
| except GoogleAdsException as ex: | ||
| print( | ||
| f'Request with ID "{ex.request_id}" failed with status ' | ||
| f'"{ex.error.code().name}" and includes the following errors:' | ||
| ) | ||
| for error in ex.failure.errors: | ||
| print(f'\tError with message "{error.message}".') | ||
| if error.location: | ||
| for field_path_element in error.location.field_path_elements: | ||
| print(f"\t\tOn field: {field_path_element.field_name}") | ||
| sys.exit(1) | ||
|
|
||
|
|
||
| def _remove_merchant_center_link( | ||
| client, merchant_center_link_service, customer_id, merchant_center_link | ||
| ): | ||
| """Removes a Merchant Center link from a Google Ads client customer account. | ||
| Args: | ||
| client: An initialized Google Ads client. | ||
| merchant_center_link_service: An initialized | ||
| MerchantCenterLinkService client. | ||
| customer_id: The Google Ads customer ID of the account that has the link | ||
| request. | ||
| merchant_center_link: The MerchantCenterLink object to remove. | ||
| """ | ||
| # Create a single remove operation, specifying the Merchant Center link | ||
| # resource name. | ||
| operation = client.get_type("MerchantCenterLinkOperation", version="v6") | ||
| operation.remove = merchant_center_link.resource_name | ||
|
|
||
| # Send the operation in a mutate request. | ||
| response = merchant_center_link_service.mutate_merchant_center_link( | ||
| customer_id, operation | ||
| ) | ||
| print( | ||
| "Removed Merchant Center link with resource name " | ||
| f"'{response.result.resource_name}'." | ||
| ) | ||
|
|
||
|
|
||
| if __name__ == "__main__": | ||
| # GoogleAdsClient will read the google-ads.yaml configuration file in the | ||
| # home directory if none is specified. | ||
| google_ads_client = GoogleAdsClient.load_from_storage() | ||
|
|
||
| parser = argparse.ArgumentParser( | ||
| description=( | ||
| "Demonstrates how to reject a Merchant Center link request." | ||
| ) | ||
| ) | ||
| # The following argument(s) should be provided to run the example. | ||
| parser.add_argument( | ||
| "-c", | ||
| "--customer_id", | ||
| type=str, | ||
| required=True, | ||
| help="The Google Ads customer ID.", | ||
| ) | ||
| parser.add_argument( | ||
| "-m", | ||
| "--merchant_center_account_id", | ||
| type=int, | ||
| required=True, | ||
| help="The Merchant Center account ID for the account requesting to " | ||
| "link.", | ||
| ) | ||
| args = parser.parse_args() | ||
|
|
||
| main(google_ads_client, args.customer_id, args.merchant_center_account_id) |
Oops, something went wrong.