Changes for release v15_0.

googleads · Oct 19, 2023 · 310a10b · 310a10b
1 parent eb2b981
commit 310a10b
Show file tree

Hide file tree

Showing 1,522 changed files with 232,523 additions and 525 deletions.
diff --git a/ChangeLog b/ChangeLog
@@ -1,3 +1,12 @@
+* 22.1.0
+- Google Ads API v15 release.
+- Add configuration option allowing developer token to be ignored.
+- Make "impersonation_email" an optional configuration for service accounts.
+- Redact PII fields from new LocalServicesLead and LocalServicesLeadConversation in logs.
+- Add DMA consent to conversions and Customer Match examples.
+- Update enhanced conversions examples to fit with for-leads and for-web workflows.
+- Update usage of ProductBiddingCategoryConstant to ProductCategoryConstant in examples.
+
 * 22.0.0
 - Remove support for Google Ads API v12.
 

diff --git a/examples/account_management/approve_merchant_center_link.py b/examples/account_management/approve_merchant_center_link.py
@@ -21,6 +21,11 @@
 To run this code 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.
+
+NOTE: This code example uses version v14 of the Google Ads API. Version v15 of
+the Google Ads API replaces MerchantCenterLinkService with
+ProductLinkInvitationService and ProductLinkService. We will add new code
+examples using these services shortly.
 """
 
 import argparse

diff --git a/examples/account_management/create_customer.py b/examples/account_management/create_customer.py
@@ -58,7 +58,7 @@ def main(client, manager_customer_id):
 if __name__ == "__main__":
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v15")
 
     parser = argparse.ArgumentParser(
         description=("Creates a new client under the given manager.")

diff --git a/examples/account_management/get_account_hierarchy.py b/examples/account_management/get_account_hierarchy.py
@@ -179,7 +179,7 @@ def print_account_hierarchy(
 if __name__ == "__main__":
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v15")
 
     parser = argparse.ArgumentParser(
         description="This example gets the account hierarchy of the specified "

diff --git a/examples/account_management/get_change_details.py b/examples/account_management/get_change_details.py
@@ -186,7 +186,7 @@ def main(client, customer_id):
 if __name__ == "__main__":
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v15")
 
     parser = argparse.ArgumentParser(
         description="This example gets specific details about the most recent "

diff --git a/examples/account_management/get_change_summary.py b/examples/account_management/get_change_summary.py
@@ -85,7 +85,7 @@ def main(client, customer_id):
 if __name__ == "__main__":
     # GoogleAdsClient will read a google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v15")
 
     parser = argparse.ArgumentParser(
         description=(

diff --git a/examples/account_management/invite_user_with_access_role.py b/examples/account_management/invite_user_with_access_role.py
@@ -59,7 +59,7 @@ def main(client, customer_id, email_address, access_role):
 if __name__ == "__main__":
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v15")
 
     parser = argparse.ArgumentParser(
         description=(

diff --git a/examples/account_management/link_manager_to_client.py b/examples/account_management/link_manager_to_client.py
@@ -85,8 +85,12 @@ def main(client, customer_id, manager_customer_id):
     )
     manager_link_operation = client.get_type("CustomerManagerLinkOperation")
     manager_link = manager_link_operation.update
-    manager_link.resource_name = customer_manager_link_service.customer_manager_link_path(
-        customer_id, manager_customer_id, manager_link_id,
+    manager_link.resource_name = (
+        customer_manager_link_service.customer_manager_link_path(
+            customer_id,
+            manager_customer_id,
+            manager_link_id,
+        )
     )
 
     manager_link.status = client.enums.ManagerLinkStatusEnum.ACTIVE
@@ -108,7 +112,7 @@ def main(client, customer_id, manager_customer_id):
 if __name__ == "__main__":
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v15")
 
     parser = argparse.ArgumentParser(
         description=(

diff --git a/examples/account_management/list_accessible_customers.py b/examples/account_management/list_accessible_customers.py
@@ -44,7 +44,7 @@ def main(client):
 if __name__ == "__main__":
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v15")
 
     try:
         main(googleads_client)

diff --git a/examples/account_management/reject_merchant_center_link.py b/examples/account_management/reject_merchant_center_link.py
@@ -22,6 +22,11 @@
 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.
+
+NOTE: This code example uses version v14 of the Google Ads API. Version v15 of
+the Google Ads API replaces MerchantCenterLinkService with
+ProductLinkInvitationService and ProductLinkService. We will add new code
+examples using these services shortly.
 """
 
 import argparse
@@ -45,8 +50,10 @@ def main(client, customer_id, merchant_center_account_id):
         "MerchantCenterLinkService"
     )
     # 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=customer_id
+    list_merchant_center_links_response = (
+        merchant_center_link_service.list_merchant_center_links(
+            customer_id=customer_id
+        )
     )
 
     number_of_links = len(

diff --git a/examples/account_management/update_user_access.py b/examples/account_management/update_user_access.py
@@ -113,8 +113,10 @@ def modify_user_access(client, customer_id, user_id, access_role):
     customer_user_access_op = client.get_type("CustomerUserAccessOperation")
     access_role_enum = client.enums.AccessRoleEnum
     customer_user_access = customer_user_access_op.update
-    customer_user_access.resource_name = customer_user_access_service.customer_user_access_path(
-        customer_id, user_id
+    customer_user_access.resource_name = (
+        customer_user_access_service.customer_user_access_path(
+            customer_id, user_id
+        )
     )
     customer_user_access.access_role = getattr(access_role_enum, access_role)
     client.copy_from(
@@ -135,7 +137,7 @@ def modify_user_access(client, customer_id, user_id, access_role):
 if __name__ == "__main__":
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v15")
 
     parser = argparse.ArgumentParser(
         description="This code example updates the access role of a user, "

diff --git a/examples/advanced_operations/add_ad_customizer.py b/examples/advanced_operations/add_ad_customizer.py
@@ -263,7 +263,7 @@ def create_ad_with_customizations(
 if __name__ == "__main__":
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v15")
 
     parser = argparse.ArgumentParser(
         description=(
@@ -281,7 +281,11 @@ def create_ad_with_customizations(
         help="The Google Ads customer ID.",
     )
     parser.add_argument(
-        "-a", "--ad_group_id", type=str, required=True, help="An ad group ID.",
+        "-a",
+        "--ad_group_id",
+        type=str,
+        required=True,
+        help="An ad group ID.",
     )
     args = parser.parse_args()
 

diff --git a/examples/advanced_operations/add_ad_group_bid_modifier.py b/examples/advanced_operations/add_ad_group_bid_modifier.py
@@ -51,7 +51,8 @@ def main(client, customer_id, ad_group_id, bid_modifier_value):
 
     # Add the ad group bid modifier.
     ad_group_bm_response = ad_group_bm_service.mutate_ad_group_bid_modifiers(
-        customer_id=customer_id, operations=[ad_group_bid_modifier_operation],
+        customer_id=customer_id,
+        operations=[ad_group_bid_modifier_operation],
     )
     # [END add_ad_group_bid_modifier]
 
@@ -64,7 +65,7 @@ def main(client, customer_id, ad_group_id, bid_modifier_value):
 if __name__ == "__main__":
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v15")
 
     parser = argparse.ArgumentParser(
         description=(

diff --git a/examples/advanced_operations/add_app_campaign.py b/examples/advanced_operations/add_app_campaign.py
@@ -183,8 +183,8 @@ def set_campaign_targeting_criteria(
         )
         campaign_criterion = campaign_criterion_operation.create
         campaign_criterion.campaign = campaign_resource_name
-        campaign_criterion.location.geo_target_constant = geo_target_constant_service.geo_target_constant_path(
-            location_id
+        campaign_criterion.location.geo_target_constant = (
+            geo_target_constant_service.geo_target_constant_path(location_id)
         )
         campaign_criterion_operations.append(campaign_criterion_operation)
 
@@ -195,8 +195,8 @@ def set_campaign_targeting_criteria(
         )
         campaign_criterion = campaign_criterion_operation.create
         campaign_criterion.campaign = campaign_resource_name
-        campaign_criterion.language.language_constant = googleads_service.language_constant_path(
-            language_id
+        campaign_criterion.language.language_constant = (
+            googleads_service.language_constant_path(language_id)
         )
         campaign_criterion_operations.append(campaign_criterion_operation)
 
@@ -295,7 +295,7 @@ def create_ad_text_asset(client, text):
 if __name__ == "__main__":
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v15")
 
     parser = argparse.ArgumentParser(
         description=(

diff --git a/examples/advanced_operations/add_bidding_data_exclusion.py b/examples/advanced_operations/add_bidding_data_exclusion.py
@@ -80,7 +80,7 @@ def main(client, customer_id, start_date_time, end_date_time):
 if __name__ == "__main__":
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v15")
 
     parser = argparse.ArgumentParser(
         description="Adds a data exclusion for conversions in Smart Bidding "

diff --git a/examples/advanced_operations/add_bidding_seasonality_adjustment.py b/examples/advanced_operations/add_bidding_seasonality_adjustment.py
@@ -94,7 +94,7 @@ def main(
 if __name__ == "__main__":
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v15")
 
     parser = argparse.ArgumentParser(
         description="Adds a seasonality adjustment for conversions in Smart "

diff --git a/examples/advanced_operations/add_call_ad.py b/examples/advanced_operations/add_call_ad.py
@@ -101,7 +101,7 @@ def main(
 if __name__ == "__main__":
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v15")
 
     parser = argparse.ArgumentParser(
         description=("Adds a call extension to a specific account.")
@@ -115,7 +115,11 @@ def main(
         help="The Google Ads customer ID.",
     )
     parser.add_argument(
-        "-a", "--ad_group_id", type=str, required=True, help="An ad group ID.",
+        "-a",
+        "--ad_group_id",
+        type=str,
+        required=True,
+        help="An ad group ID.",
     )
     parser.add_argument(
         "-n",

diff --git a/examples/advanced_operations/add_display_upload_ad.py b/examples/advanced_operations/add_display_upload_ad.py
@@ -150,7 +150,7 @@ def create_display_upload_ad_group_ad(
 if __name__ == "__main__":
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v15")
 
     parser = argparse.ArgumentParser(
         description="Adds a display upload ad to a given ad group."

diff --git a/examples/advanced_operations/add_dynamic_page_feed_asset.py b/examples/advanced_operations/add_dynamic_page_feed_asset.py
@@ -260,11 +260,13 @@ def add_dsa_target(client, customer_id, ad_group_id, dsa_page_url_label):
 if __name__ == "__main__":
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v15")
 
-    parser = argparse.ArgumentParser(description=(
-        "Adds a page feed with URLs for a Dynamic Search Ads campaign"
-    ))
+    parser = argparse.ArgumentParser(
+        description=(
+            "Adds a page feed with URLs for a Dynamic Search Ads campaign"
+        )
+    )
     # The following argument(s) should be provided to run the example.
     parser.add_argument(
         "-c",

diff --git a/examples/advanced_operations/add_dynamic_search_ads.py b/examples/advanced_operations/add_dynamic_search_ads.py
@@ -260,7 +260,7 @@ def add_webpage_criterion(client, customer_id, ad_group_resource_name):
 if __name__ == "__main__":
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v14")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v15")
 
     parser = argparse.ArgumentParser(
         description=(