Changes for release v8_0. (#449)

Author: laurachevalier4

ChangeLog

@@ -1,3 +1,8 @@
+* 12.0.0
+- Google Ads API v8_0 release.
+- Deprecate Google Ads API v5_0.
+- *NOTE* This will be the last release to support Python 3.6.
+
 * 11.0.2
 - Update dataclasses dependency so it's only installed when using Python < 3.7
 

examples/account_management/approve_merchant_center_link.py

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

examples/account_management/get_account_information.py

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

examples/account_management/get_change_details.py

@@ -123,16 +123,21 @@ def main(client, customer_id):
 
         print(
             f"On {event.change_date_time}, user {event.user_email} "
-            f"used interface {event.client_type} to perform a(n) "
-            f"{event.resource_change_operation} operation on a "
-            f"{event.change_resource_type} with resource name "
+            f"used interface {event.client_type.name} to perform a(n) "
+            f"{event.resource_change_operation.name} operation on a "
+            f"{event.change_resource_type.name} with resource name "
             f"'{event.change_resource_name}'"
         )
 
         operation_type = event.resource_change_operation.name
 
         if operation_type in ("UPDATE", "CREATE"):
             for changed_field in event.changed_fields.paths:
+                # Change field name from "type" to "type_" so that it doesn't
+                # raise an exception when accessed on the protobuf object, see:
+                # https://developers.google.com/google-ads/api/docs/client-libs/python/library-version-10#field_names_that_are_reserved_words
+                if changed_field == "type":
+                    changed_field = "type_"
                 new_value = get_nested_attr(new_resource, changed_field)
                 if operation_type == "CREATE":
                     print(f"\t{changed_field} set to {new_value}")
@@ -147,7 +152,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="v7")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v8")
 
     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="v7")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v8")
 
     parser = argparse.ArgumentParser(
         description=(

examples/account_management/get_pending_invitations.py

@@ -57,13 +57,15 @@ def main(client, customer_id):
                 f"access role: {invite.access_role}, and "
                 f"created on: {invite.creation_date_time} was found."
             )
+
+
 # [END get_pending_invitations]
 
 
 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="v7")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v8")
 
     parser = argparse.ArgumentParser(
         description=("Retrieves pending invitations for a customer account.")

examples/account_management/invite_user_with_access_role.py

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

examples/account_management/link_manager_to_client.py

@@ -85,12 +85,8 @@ 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.get_type(
@@ -131,7 +127,7 @@ def _handle_googleads_exception(exception):
 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="v7")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v8")
 
     parser = argparse.ArgumentParser(
         description=(