Changes for release 12_0.

ChangeLog

@@ -1,3 +1,13 @@
+* 18.2.0
+- Google Ads API v12 release.
+- Bump proto-plus to 1.22.1.
+- Remove example for Add Dynamic Page Feed.
+- Remove example for Add Smart Display Ad.
+- Remove example for Add Local Campaign.
+- Remove usage of GenerateProductMixes in Forecast Reach example.
+- Update example Create Experiment to rename ExperimentArm.trial to ExperimentArm.experiment.
+- Update example Add Smart Campaign to support KeywordThemeSuggestion changes.
+
 * 18.1.0
 - Google Ads API v11_1 release.
 - Bump protobuf dependency to version 4.21.5.

examples/account_management/approve_merchant_center_link.py

@@ -125,7 +125,7 @@ def update_merchant_center_link_status(
 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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     parser = argparse.ArgumentParser(
         description=("Approves a Merchant Center link request.")

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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     parser = argparse.ArgumentParser(
         description=("Creates a new client under the given manager.")

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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     parser = argparse.ArgumentParser(
         description="This example gets the account hierarchy of the specified "

examples/account_management/get_account_information.py

@@ -55,7 +55,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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     parser = argparse.ArgumentParser(
         description=(

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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     parser = argparse.ArgumentParser(
         description="This example gets specific details about the most recent "

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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     parser = argparse.ArgumentParser(
         description=(

examples/account_management/get_pending_invitations.py

@@ -65,7 +65,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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     parser = argparse.ArgumentParser(
         description=("Retrieves pending invitations for a customer account.")

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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     parser = argparse.ArgumentParser(
         description=(

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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     parser = argparse.ArgumentParser(
         description=(

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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     try:
         main(googleads_client)

examples/account_management/reject_merchant_center_link.py

@@ -131,7 +131,7 @@ def remove_merchant_center_link(
 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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     parser = argparse.ArgumentParser(
         description=(

examples/account_management/update_user_access.py

@@ -137,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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     parser = argparse.ArgumentParser(
         description="This code example updates the access role of a user, "

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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     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()
 

examples/advanced_operations/add_ad_group_bid_modifier.py

@@ -65,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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     parser = argparse.ArgumentParser(
         description=(

examples/advanced_operations/add_app_campaign.py

@@ -42,9 +42,7 @@ def main(client, customer_id):
     )
 
     # Sets campaign targeting.
-    set_campaign_targeting_criteria(
-        client, customer_id, campaign_resource_name
-    )
+    set_campaign_targeting_criteria(client, customer_id, campaign_resource_name)
 
     # Creates an Ad Group.
     ad_group_resource_name = create_ad_group(
@@ -297,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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     parser = argparse.ArgumentParser(
         description=(

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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     parser = argparse.ArgumentParser(
         description="Adds a data exclusion for conversions in Smart Bidding "

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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     parser = argparse.ArgumentParser(
         description="Adds a seasonality adjustment for conversions in Smart "

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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     parser = argparse.ArgumentParser(
         description=("Adds a call extension to a specific account.")

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="v11")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v12")
 
     parser = argparse.ArgumentParser(
         description="Adds a display upload ad to a given ad group."