Changes for release v23_0.

ChangeLog

@@ -1,3 +1,7 @@
+* 29.0.0
+- Google Ads API v23_0 release.
+- Remove Google Ads API v19.
+
 * 28.4.1
 -  Fix issues with async functionality per issue #1045.
 

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.v22.resources.types.customer import Customer
-from google.ads.googleads.v22.services.services.customer_service.client import (
+from google.ads.googleads.v23.resources.types.customer import Customer
+from google.ads.googleads.v23.services.services.customer_service.client import (
     CustomerServiceClient,
 )
-from google.ads.googleads.v22.services.types.customer_service import (
+from google.ads.googleads.v23.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="v22")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v23")
 
     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.v22.services.services.google_ads_service.client import (
+from google.ads.googleads.v23.services.services.google_ads_service.client import (
     GoogleAdsServiceClient,
 )
-from google.ads.googleads.v22.services.services.customer_service.client import (
+from google.ads.googleads.v23.services.services.customer_service.client import (
     CustomerServiceClient,
 )
-from google.ads.googleads.v22.resources.types.customer_client import (
+from google.ads.googleads.v23.resources.types.customer_client import (
     CustomerClient,
 )
-from google.ads.googleads.v22.services.types.google_ads_service import (
+from google.ads.googleads.v23.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="v22")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v23")
     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.v22.services.services.google_ads_service.client import (
+from google.ads.googleads.v23.services.services.google_ads_service.client import (
     GoogleAdsServiceClient,
 )
-from google.ads.googleads.v22.services.types.google_ads_service import (
+from google.ads.googleads.v23.services.types.google_ads_service import (
     SearchGoogleAdsRequest,
     SearchPagedResponse,
     GoogleAdsRow,
 )
-from google.ads.googleads.v22.resources.types.change_event import ChangeEvent
+from google.ads.googleads.v23.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="v22")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v23")
     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.v22.services.services.google_ads_service.client import (
+from google.ads.googleads.v23.services.services.google_ads_service.client import (
     GoogleAdsServiceClient,
 )
-from google.ads.googleads.v22.services.types.google_ads_service import (
+from google.ads.googleads.v23.services.types.google_ads_service import (
     SearchGoogleAdsRequest,
     SearchPagedResponse,
     GoogleAdsRow,
 )
-from google.ads.googleads.v22.resources.types.change_status import ChangeStatus
+from google.ads.googleads.v23.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="v22")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v23")
 
     try:
         main(googleads_client, args.customer_id)

examples/account_management/invite_user_with_access_role.py

@@ -23,18 +23,18 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v22.services.services.customer_user_access_invitation_service.client import (
+from google.ads.googleads.v23.services.services.customer_user_access_invitation_service.client import (
     CustomerUserAccessInvitationServiceClient,
 )
-from google.ads.googleads.v22.services.types.customer_user_access_invitation_service import (
+from google.ads.googleads.v23.services.types.customer_user_access_invitation_service import (
     CustomerUserAccessInvitationOperation,
     MutateCustomerUserAccessInvitationResponse,
 )
-from google.ads.googleads.v22.resources.types.customer_user_access_invitation import (
+from google.ads.googleads.v23.resources.types.customer_user_access_invitation import (
     CustomerUserAccessInvitation,
 )
 
-# AccessRoleEnum is part of google.ads.googleads.v22.enums.types.access_role
+# AccessRoleEnum is part of google.ads.googleads.v23.enums.types.access_role
 # but it's accessed via client.enums.AccessRoleEnum, so direct import for type hint might not be strictly needed for the parameter.
 # The field invitation.access_role expects an int (the enum value).
 
@@ -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="v22")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v23")
 
     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.v22.services.services.customer_client_link_service.client import (
+from google.ads.googleads.v23.services.services.customer_client_link_service.client import (
     CustomerClientLinkServiceClient,
 )
-from google.ads.googleads.v22.services.types.customer_client_link_service import (
+from google.ads.googleads.v23.services.types.customer_client_link_service import (
     CustomerClientLinkOperation,
     MutateCustomerClientLinkResponse,
 )
-from google.ads.googleads.v22.resources.types.customer_client_link import (
+from google.ads.googleads.v23.resources.types.customer_client_link import (
     CustomerClientLink,
 )
-from google.ads.googleads.v22.services.services.google_ads_service.client import (
+from google.ads.googleads.v23.services.services.google_ads_service.client import (
     GoogleAdsServiceClient,
 )
-from google.ads.googleads.v22.services.types.google_ads_service import (
+from google.ads.googleads.v23.services.types.google_ads_service import (
     SearchPagedResponse,
     GoogleAdsRow,
 )
-from google.ads.googleads.v22.services.services.customer_manager_link_service.client import (
+from google.ads.googleads.v23.services.services.customer_manager_link_service.client import (
     CustomerManagerLinkServiceClient,
 )
-from google.ads.googleads.v22.services.types.customer_manager_link_service import (
+from google.ads.googleads.v23.services.types.customer_manager_link_service import (
     CustomerManagerLinkOperation,
     MutateCustomerManagerLinkResponse,
 )
-from google.ads.googleads.v22.resources.types.customer_manager_link import (
+from google.ads.googleads.v23.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="v22")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v23")
     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.v22.services.services.customer_service.client import (
+from google.ads.googleads.v23.services.services.customer_service.client import (
     CustomerServiceClient,
 )
-from google.ads.googleads.v22.services.types.customer_service import (
+from google.ads.googleads.v23.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="v22")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v23")
 
     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.v22.services.services.google_ads_service.client import (
+from google.ads.googleads.v23.services.services.google_ads_service.client import (
     GoogleAdsServiceClient,
 )
-from google.ads.googleads.v22.services.types.google_ads_service import (
+from google.ads.googleads.v23.services.types.google_ads_service import (
     SearchGoogleAdsRequest,
     SearchPagedResponse,
 )
-from google.ads.googleads.v22.resources.types.customer_user_access import (
+from google.ads.googleads.v23.resources.types.customer_user_access import (
     CustomerUserAccess,
 )
-from google.ads.googleads.v22.services.services.customer_user_access_service.client import (
+from google.ads.googleads.v23.services.services.customer_user_access_service.client import (
     CustomerUserAccessServiceClient,
 )
-from google.ads.googleads.v22.services.types.customer_user_access_service import (
+from google.ads.googleads.v23.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="v22")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v23")
     try:
         main(
             googleads_client,

examples/account_management/verify_advertiser_identity.py

@@ -24,13 +24,13 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v22.enums.types.identity_verification_program_status import (
+from google.ads.googleads.v23.enums.types.identity_verification_program_status import (
     IdentityVerificationProgramStatusEnum,
 )
-from google.ads.googleads.v22.services.services.identity_verification_service.client import (
+from google.ads.googleads.v23.services.services.identity_verification_service.client import (
     IdentityVerificationServiceClient,
 )
-from google.ads.googleads.v22.services.types.identity_verification_service import (
+from google.ads.googleads.v23.services.types.identity_verification_service import (
     GetIdentityVerificationResponse,
     IdentityVerification,
     IdentityVerificationProgress,
@@ -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="v22")
+    googleads_client = GoogleAdsClient.load_from_storage(version="v23")
 
     try:
         main(googleads_client, args.customer_id)

examples/advanced_operations/add_ad_customizer.py

@@ -25,25 +25,25 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v22.common.types import AdTextAsset
-from google.ads.googleads.v22.resources.types import (
+from google.ads.googleads.v23.common.types import AdTextAsset
+from google.ads.googleads.v23.resources.types import (
     AdGroupAd,
     AdGroupCustomizer,
     CustomizerAttribute,
 )
-from google.ads.googleads.v22.services.services.ad_group_ad_service import (
+from google.ads.googleads.v23.services.services.ad_group_ad_service import (
     AdGroupAdServiceClient,
 )
-from google.ads.googleads.v22.services.services.ad_group_customizer_service import (
+from google.ads.googleads.v23.services.services.ad_group_customizer_service import (
     AdGroupCustomizerServiceClient,
 )
-from google.ads.googleads.v22.services.services.customizer_attribute_service import (
+from google.ads.googleads.v23.services.services.customizer_attribute_service import (
     CustomizerAttributeServiceClient,
 )
-from google.ads.googleads.v22.services.services.google_ads_service import (
+from google.ads.googleads.v23.services.services.google_ads_service import (
     GoogleAdsServiceClient,
 )
-from google.ads.googleads.v22.services.types import (
+from google.ads.googleads.v23.services.types import (
     AdGroupAdOperation,
     AdGroupCustomizerOperation,
     CustomizerAttributeOperation,
@@ -342,7 +342,7 @@ def create_ad_with_customizations(
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
     googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(
-        version="v22"
+        version="v23"
     )
 
     try:

examples/advanced_operations/add_ad_group_bid_modifier.py

@@ -23,17 +23,17 @@
 
 from google.ads.googleads.client import GoogleAdsClient
 from google.ads.googleads.errors import GoogleAdsException
-from google.ads.googleads.v22.enums.types.device import DeviceEnum
-from google.ads.googleads.v22.resources.types.ad_group_bid_modifier import (
+from google.ads.googleads.v23.enums.types.device import DeviceEnum
+from google.ads.googleads.v23.resources.types.ad_group_bid_modifier import (
     AdGroupBidModifier,
 )
-from google.ads.googleads.v22.services.services.ad_group_bid_modifier_service import (
+from google.ads.googleads.v23.services.services.ad_group_bid_modifier_service import (
     AdGroupBidModifierServiceClient,
 )
-from google.ads.googleads.v22.services.services.ad_group_service import (
+from google.ads.googleads.v23.services.services.ad_group_service import (
     AdGroupServiceClient,
 )
-from google.ads.googleads.v22.services.types.ad_group_bid_modifier_service import (
+from google.ads.googleads.v23.services.types.ad_group_bid_modifier_service import (
     AdGroupBidModifierOperation,
     MutateAdGroupBidModifiersResponse,
 )
@@ -120,7 +120,7 @@ def main(
     # GoogleAdsClient will read the google-ads.yaml configuration file in the
     # home directory if none is specified.
     googleads_client: GoogleAdsClient = GoogleAdsClient.load_from_storage(
-        version="v22"
+        version="v23"
     )
 
     try: