Merge branch 'main' into add-type-hints-advanced-ops

Author: BenRKarl

ChangeLog

@@ -1,3 +1,11 @@
+* 28.0.0
+- Google Ads API v21_0 release.
+- Updated to Google Ads API v19_0 and v20_0 to include EU political advertising changes.
+- Remove Google Ads API v18.
+- Add deprecation warnings for Python 3.9 users.
+- Add type annotations to all examples.
+- Add unit tests covering some examples.
+
 * 27.0.0
 - Google Ads API v20_0 release.
 - Remove Google Ads API v17.

examples/account_management/create_customer.py

@@ -27,11 +27,11 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v20.resources.types.customer import Customer
-from google.ads.googleads.v20.services.services.customer_service.client import (
+from google.ads.googleads.v21.resources.types.customer import Customer
+from google.ads.googleads.v21.services.services.customer_service.client import (
     CustomerServiceClient,
 )
-from google.ads.googleads.v20.services.types.customer_service import (
+from google.ads.googleads.v21.services.types.customer_service import (
     CreateCustomerClientResponse,
 )
 
@@ -91,7 +91,7 @@ def main(client: GoogleAdsClient, manager_customer_id: str) -> None:
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
 
     try:
         main(googleads_client, args.manager_customer_id)

examples/account_management/get_account_hierarchy.py

@@ -28,16 +28,16 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v20.services.services.google_ads_service.client import (
+from google.ads.googleads.v21.services.services.google_ads_service.client import (
     GoogleAdsServiceClient,
 )
-from google.ads.googleads.v20.services.services.customer_service.client import (
+from google.ads.googleads.v21.services.services.customer_service.client import (
     CustomerServiceClient,
 )
-from google.ads.googleads.v20.resources.types.customer_client import (
+from google.ads.googleads.v21.resources.types.customer_client import (
     CustomerClient,
 )
-from google.ads.googleads.v20.services.types.google_ads_service import (
+from google.ads.googleads.v21.services.types.google_ads_service import (
     SearchPagedResponse,
     GoogleAdsRow,
 )
@@ -238,7 +238,7 @@ def print_account_hierarchy(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
     try:
         main(googleads_client, args.login_customer_id)
     except GoogleAdsException as ex:

examples/account_management/get_change_details.py

@@ -28,15 +28,15 @@
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
 from google.ads.googleads.util import get_nested_attr
-from google.ads.googleads.v20.services.services.google_ads_service.client import (
+from google.ads.googleads.v21.services.services.google_ads_service.client import (
     GoogleAdsServiceClient,
 )
-from google.ads.googleads.v20.services.types.google_ads_service import (
+from google.ads.googleads.v21.services.types.google_ads_service import (
     SearchGoogleAdsRequest,
     SearchPagedResponse,
     GoogleAdsRow,
 )
-from google.ads.googleads.v20.resources.types.change_event import ChangeEvent
+from google.ads.googleads.v21.resources.types.change_event import ChangeEvent
 
 
 # [START get_change_details]
@@ -218,7 +218,7 @@ def main(client: GoogleAdsClient, customer_id: str) -> None:
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
     try:
         main(googleads_client, args.customer_id)
     except GoogleAdsException as ex:

examples/account_management/get_change_summary.py

@@ -22,15 +22,15 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v20.services.services.google_ads_service.client import (
+from google.ads.googleads.v21.services.services.google_ads_service.client import (
     GoogleAdsServiceClient,
 )
-from google.ads.googleads.v20.services.types.google_ads_service import (
+from google.ads.googleads.v21.services.types.google_ads_service import (
     SearchGoogleAdsRequest,
     SearchPagedResponse,
     GoogleAdsRow,
 )
-from google.ads.googleads.v20.resources.types.change_status import ChangeStatus
+from google.ads.googleads.v21.resources.types.change_status import ChangeStatus
 
 
 # [START get_change_summary]
@@ -110,7 +110,7 @@ def main(client: GoogleAdsClient, customer_id: str) -> None:
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
 
     try:
         main(googleads_client, args.customer_id)

examples/account_management/invite_user_with_access_role.py

@@ -23,14 +23,14 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v20.services.services.customer_user_access_invitation_service.client import (
+from google.ads.googleads.v21.services.services.customer_user_access_invitation_service.client import (
     CustomerUserAccessInvitationServiceClient,
 )
-from google.ads.googleads.v20.services.types.customer_user_access_invitation_service import (
+from google.ads.googleads.v21.services.types.customer_user_access_invitation_service import (
     CustomerUserAccessInvitationOperation,
     MutateCustomerUserAccessInvitationResponse,
 )
-from google.ads.googleads.v20.resources.types.customer_user_access_invitation import (
+from google.ads.googleads.v21.resources.types.customer_user_access_invitation import (
     CustomerUserAccessInvitation,
 )
 
@@ -115,7 +115,7 @@ def 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="v20")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
 
     try:
         main(

examples/account_management/link_manager_to_client.py

@@ -22,31 +22,31 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v20.services.services.customer_client_link_service.client import (
+from google.ads.googleads.v21.services.services.customer_client_link_service.client import (
     CustomerClientLinkServiceClient,
 )
-from google.ads.googleads.v20.services.types.customer_client_link_service import (
+from google.ads.googleads.v21.services.types.customer_client_link_service import (
     CustomerClientLinkOperation,
     MutateCustomerClientLinkResponse,
 )
-from google.ads.googleads.v20.resources.types.customer_client_link import (
+from google.ads.googleads.v21.resources.types.customer_client_link import (
     CustomerClientLink,
 )
-from google.ads.googleads.v20.services.services.google_ads_service.client import (
+from google.ads.googleads.v21.services.services.google_ads_service.client import (
     GoogleAdsServiceClient,
 )
-from google.ads.googleads.v20.services.types.google_ads_service import (
+from google.ads.googleads.v21.services.types.google_ads_service import (
     SearchPagedResponse,
     GoogleAdsRow,
 )
-from google.ads.googleads.v20.services.services.customer_manager_link_service.client import (
+from google.ads.googleads.v21.services.services.customer_manager_link_service.client import (
     CustomerManagerLinkServiceClient,
 )
-from google.ads.googleads.v20.services.types.customer_manager_link_service import (
+from google.ads.googleads.v21.services.types.customer_manager_link_service import (
     CustomerManagerLinkOperation,
     MutateCustomerManagerLinkResponse,
 )
-from google.ads.googleads.v20.resources.types.customer_manager_link import (
+from google.ads.googleads.v21.resources.types.customer_manager_link import (
     CustomerManagerLink,
 )
 
@@ -179,7 +179,7 @@ def 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="v20")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
     try:
         main(googleads_client, args.customer_id, args.manager_customer_id)
     except GoogleAdsException as ex:

examples/account_management/list_accessible_customers.py

@@ -26,10 +26,10 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v20.services.services.customer_service.client import (
+from google.ads.googleads.v21.services.services.customer_service.client import (
     CustomerServiceClient,
 )
-from google.ads.googleads.v20.services.types.customer_service import (
+from google.ads.googleads.v21.services.types.customer_service import (
     ListAccessibleCustomersResponse,
 )
 
@@ -55,7 +55,7 @@ def main(client: GoogleAdsClient) -> None:
 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="v20")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
 
     try:
         main(googleads_client)

examples/account_management/update_user_access.py

@@ -26,20 +26,20 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v20.services.services.google_ads_service.client import (
+from google.ads.googleads.v21.services.services.google_ads_service.client import (
     GoogleAdsServiceClient,
 )
-from google.ads.googleads.v20.services.types.google_ads_service import (
+from google.ads.googleads.v21.services.types.google_ads_service import (
     SearchGoogleAdsRequest,
     SearchPagedResponse,
 )
-from google.ads.googleads.v20.resources.types.customer_user_access import (
+from google.ads.googleads.v21.resources.types.customer_user_access import (
     CustomerUserAccess,
 )
-from google.ads.googleads.v20.services.services.customer_user_access_service.client import (
+from google.ads.googleads.v21.services.services.customer_user_access_service.client import (
     CustomerUserAccessServiceClient,
 )
-from google.ads.googleads.v20.services.types.customer_user_access_service import (
+from google.ads.googleads.v21.services.types.customer_user_access_service import (
     CustomerUserAccessOperation,
     MutateCustomerUserAccessResponse,
 )
@@ -219,7 +219,7 @@ def modify_user_access(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
     try:
         main(
             googleads_client,

examples/account_management/verify_advertiser_identity.py

@@ -183,7 +183,7 @@ def start_identity_verification(
 
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
-    googleads_client = GoogleAdsClient.load_from_storage(version="v20")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v21")
 
     try:
         main(googleads_client, args.customer_id)