Changes for release v23.

CHANGELOG.md

@@ -1,3 +1,7 @@
+42.0.0 - 2026-01-28
+-------------------
+- Add support and examples for v23 of the Google Ads API.
+
 41.1.0 - 2025-12-04
 -------------------
 - Add support for application default credentials. 

README.md

@@ -18,12 +18,12 @@ This project hosts the Java client library for the Google Ads API.
     <dependency>
       <groupId>com.google.api-ads</groupId>
       <artifactId>google-ads</artifactId>
-      <version>41.1.0</version>
+      <version>42.0.0</version>
     </dependency>
 
 ## Gradle dependency
 
-    implementation 'com.google.api-ads:google-ads:41.1.0'
+    implementation 'com.google.api-ads:google-ads:42.0.0'
 
 ## Documentation
 

buildSrc/src/main/groovy/com.google.api-ads.java-conventions.gradle

@@ -206,7 +206,7 @@ dependencies {
   api 'io.grpc:grpc-protobuf'
   api 'com.google.auth:google-auth-library-oauth2-http'
   api 'com.google.auth:google-auth-library-credentials'
-  api platform('com.google.cloud:google-cloud-shared-dependencies:3.54.1')
+  api platform('com.google.cloud:google-cloud-shared-dependencies:3.56.0')
   implementation 'com.google.guava:guava'
   implementation 'com.google.auto.service:auto-service:1.0.1'
   implementation 'javax.annotation:javax.annotation-api'

google-ads-bom/build.gradle

@@ -126,17 +126,17 @@ dependencies {
     // This makes this BOM inherit all dependency versions from the Google Cloud
     // BOM. This version is determined based on the current used version of
     // google-cloud-shared-dependencies.
-    api(platform("com.google.cloud:libraries-bom:26.72.0"))
+    api(platform("com.google.cloud:libraries-bom:26.74.0"))
 
     // Add constraints for all of this project's artifacts.
     constraints {
         api "com.google.api-ads:google-ads:${version}"
         api "com.google.api-ads:google-ads-codegen:${version}"
         api "com.google.api-ads:google-ads-shadowjar:${version}"
-        api "com.google.api-ads:google-ads-stubs-v19:${version}"
         api "com.google.api-ads:google-ads-stubs-v20:${version}"
         api "com.google.api-ads:google-ads-stubs-v21:${version}"
         api "com.google.api-ads:google-ads-stubs-v22:${version}"
+        api "com.google.api-ads:google-ads-stubs-v23:${version}"
     }
 }
 

google-ads-examples/src/main/java/com/google/ads/googleads/examples/accountmanagement/CreateCustomer.java

@@ -18,11 +18,11 @@
 import com.google.ads.googleads.examples.utils.ArgumentNames;
 import com.google.ads.googleads.examples.utils.CodeSampleParams;
 import com.google.ads.googleads.lib.GoogleAdsClient;
-import com.google.ads.googleads.v22.errors.GoogleAdsError;
-import com.google.ads.googleads.v22.errors.GoogleAdsException;
-import com.google.ads.googleads.v22.resources.Customer;
-import com.google.ads.googleads.v22.services.CreateCustomerClientResponse;
-import com.google.ads.googleads.v22.services.CustomerServiceClient;
+import com.google.ads.googleads.v23.errors.GoogleAdsError;
+import com.google.ads.googleads.v23.errors.GoogleAdsException;
+import com.google.ads.googleads.v23.resources.Customer;
+import com.google.ads.googleads.v23.services.CreateCustomerClientResponse;
+import com.google.ads.googleads.v23.services.CustomerServiceClient;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 import java.time.ZonedDateTime;

google-ads-examples/src/main/java/com/google/ads/googleads/examples/accountmanagement/GetAccountHierarchy.java

@@ -18,17 +18,17 @@
 import com.google.ads.googleads.examples.utils.ArgumentNames;
 import com.google.ads.googleads.examples.utils.CodeSampleParams;
 import com.google.ads.googleads.lib.GoogleAdsClient;
-import com.google.ads.googleads.v22.errors.GoogleAdsError;
-import com.google.ads.googleads.v22.errors.GoogleAdsException;
-import com.google.ads.googleads.v22.resources.CustomerClient;
-import com.google.ads.googleads.v22.resources.CustomerName;
-import com.google.ads.googleads.v22.services.CustomerServiceClient;
-import com.google.ads.googleads.v22.services.GoogleAdsRow;
-import com.google.ads.googleads.v22.services.GoogleAdsServiceClient;
-import com.google.ads.googleads.v22.services.GoogleAdsServiceClient.SearchPagedResponse;
-import com.google.ads.googleads.v22.services.ListAccessibleCustomersRequest;
-import com.google.ads.googleads.v22.services.ListAccessibleCustomersResponse;
-import com.google.ads.googleads.v22.services.SearchGoogleAdsRequest;
+import com.google.ads.googleads.v23.errors.GoogleAdsError;
+import com.google.ads.googleads.v23.errors.GoogleAdsException;
+import com.google.ads.googleads.v23.resources.CustomerClient;
+import com.google.ads.googleads.v23.resources.CustomerName;
+import com.google.ads.googleads.v23.services.CustomerServiceClient;
+import com.google.ads.googleads.v23.services.GoogleAdsRow;
+import com.google.ads.googleads.v23.services.GoogleAdsServiceClient;
+import com.google.ads.googleads.v23.services.GoogleAdsServiceClient.SearchPagedResponse;
+import com.google.ads.googleads.v23.services.ListAccessibleCustomersRequest;
+import com.google.ads.googleads.v23.services.ListAccessibleCustomersResponse;
+import com.google.ads.googleads.v23.services.SearchGoogleAdsRequest;
 import com.google.common.base.Strings;
 import com.google.common.collect.ArrayListMultimap;
 import com.google.common.collect.Multimap;

google-ads-examples/src/main/java/com/google/ads/googleads/examples/accountmanagement/GetChangeDetails.java

@@ -19,15 +19,15 @@
 import com.google.ads.googleads.examples.utils.CodeSampleParams;
 import com.google.ads.googleads.lib.GoogleAdsClient;
 import com.google.ads.googleads.lib.utils.FieldMasks;
-import com.google.ads.googleads.v22.enums.ChangeEventResourceTypeEnum.ChangeEventResourceType;
-import com.google.ads.googleads.v22.enums.ResourceChangeOperationEnum.ResourceChangeOperation;
-import com.google.ads.googleads.v22.errors.GoogleAdsError;
-import com.google.ads.googleads.v22.errors.GoogleAdsException;
-import com.google.ads.googleads.v22.resources.ChangeEvent;
-import com.google.ads.googleads.v22.resources.ChangeEvent.ChangedResource;
-import com.google.ads.googleads.v22.services.GoogleAdsRow;
-import com.google.ads.googleads.v22.services.GoogleAdsServiceClient;
-import com.google.ads.googleads.v22.services.GoogleAdsServiceClient.SearchPagedResponse;
+import com.google.ads.googleads.v23.enums.ChangeEventResourceTypeEnum.ChangeEventResourceType;
+import com.google.ads.googleads.v23.enums.ResourceChangeOperationEnum.ResourceChangeOperation;
+import com.google.ads.googleads.v23.errors.GoogleAdsError;
+import com.google.ads.googleads.v23.errors.GoogleAdsException;
+import com.google.ads.googleads.v23.resources.ChangeEvent;
+import com.google.ads.googleads.v23.resources.ChangeEvent.ChangedResource;
+import com.google.ads.googleads.v23.services.GoogleAdsRow;
+import com.google.ads.googleads.v23.services.GoogleAdsServiceClient;
+import com.google.ads.googleads.v23.services.GoogleAdsServiceClient.SearchPagedResponse;
 import com.google.protobuf.Message;
 import java.io.FileNotFoundException;
 import java.io.IOException;

google-ads-examples/src/main/java/com/google/ads/googleads/examples/accountmanagement/GetChangeSummary.java

@@ -18,12 +18,12 @@
 import com.google.ads.googleads.examples.utils.ArgumentNames;
 import com.google.ads.googleads.examples.utils.CodeSampleParams;
 import com.google.ads.googleads.lib.GoogleAdsClient;
-import com.google.ads.googleads.v22.errors.GoogleAdsError;
-import com.google.ads.googleads.v22.errors.GoogleAdsException;
-import com.google.ads.googleads.v22.resources.ChangeStatus;
-import com.google.ads.googleads.v22.services.GoogleAdsRow;
-import com.google.ads.googleads.v22.services.GoogleAdsServiceClient;
-import com.google.ads.googleads.v22.services.GoogleAdsServiceClient.SearchPagedResponse;
+import com.google.ads.googleads.v23.errors.GoogleAdsError;
+import com.google.ads.googleads.v23.errors.GoogleAdsException;
+import com.google.ads.googleads.v23.resources.ChangeStatus;
+import com.google.ads.googleads.v23.services.GoogleAdsRow;
+import com.google.ads.googleads.v23.services.GoogleAdsServiceClient;
+import com.google.ads.googleads.v23.services.GoogleAdsServiceClient.SearchPagedResponse;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 import java.util.Optional;

google-ads-examples/src/main/java/com/google/ads/googleads/examples/accountmanagement/InviteUserWithAccessRole.java

@@ -18,13 +18,13 @@
 import com.google.ads.googleads.examples.utils.ArgumentNames;
 import com.google.ads.googleads.examples.utils.CodeSampleParams;
 import com.google.ads.googleads.lib.GoogleAdsClient;
-import com.google.ads.googleads.v22.enums.AccessRoleEnum.AccessRole;
-import com.google.ads.googleads.v22.errors.GoogleAdsError;
-import com.google.ads.googleads.v22.errors.GoogleAdsException;
-import com.google.ads.googleads.v22.resources.CustomerUserAccessInvitation;
-import com.google.ads.googleads.v22.services.CustomerUserAccessInvitationOperation;
-import com.google.ads.googleads.v22.services.CustomerUserAccessInvitationServiceClient;
-import com.google.ads.googleads.v22.services.MutateCustomerUserAccessInvitationResponse;
+import com.google.ads.googleads.v23.enums.AccessRoleEnum.AccessRole;
+import com.google.ads.googleads.v23.errors.GoogleAdsError;
+import com.google.ads.googleads.v23.errors.GoogleAdsException;
+import com.google.ads.googleads.v23.resources.CustomerUserAccessInvitation;
+import com.google.ads.googleads.v23.services.CustomerUserAccessInvitationOperation;
+import com.google.ads.googleads.v23.services.CustomerUserAccessInvitationServiceClient;
+import com.google.ads.googleads.v23.services.MutateCustomerUserAccessInvitationResponse;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 

google-ads-examples/src/main/java/com/google/ads/googleads/examples/accountmanagement/LinkManagerToClient.java

@@ -19,19 +19,19 @@
 import com.google.ads.googleads.examples.utils.CodeSampleParams;
 import com.google.ads.googleads.lib.GoogleAdsClient;
 import com.google.ads.googleads.lib.utils.FieldMasks;
-import com.google.ads.googleads.v22.enums.ManagerLinkStatusEnum.ManagerLinkStatus;
-import com.google.ads.googleads.v22.errors.GoogleAdsError;
-import com.google.ads.googleads.v22.errors.GoogleAdsException;
-import com.google.ads.googleads.v22.services.CustomerClientLinkOperation;
-import com.google.ads.googleads.v22.services.CustomerClientLinkServiceClient;
-import com.google.ads.googleads.v22.services.CustomerManagerLinkOperation;
-import com.google.ads.googleads.v22.services.CustomerManagerLinkServiceClient;
-import com.google.ads.googleads.v22.services.GoogleAdsRow;
-import com.google.ads.googleads.v22.services.GoogleAdsServiceClient;
-import com.google.ads.googleads.v22.services.GoogleAdsServiceClient.SearchPagedResponse;
-import com.google.ads.googleads.v22.services.MutateCustomerClientLinkResponse;
-import com.google.ads.googleads.v22.services.MutateCustomerManagerLinkResponse;
-import com.google.ads.googleads.v22.utils.ResourceNames;
+import com.google.ads.googleads.v23.enums.ManagerLinkStatusEnum.ManagerLinkStatus;
+import com.google.ads.googleads.v23.errors.GoogleAdsError;
+import com.google.ads.googleads.v23.errors.GoogleAdsException;
+import com.google.ads.googleads.v23.services.CustomerClientLinkOperation;
+import com.google.ads.googleads.v23.services.CustomerClientLinkServiceClient;
+import com.google.ads.googleads.v23.services.CustomerManagerLinkOperation;
+import com.google.ads.googleads.v23.services.CustomerManagerLinkServiceClient;
+import com.google.ads.googleads.v23.services.GoogleAdsRow;
+import com.google.ads.googleads.v23.services.GoogleAdsServiceClient;
+import com.google.ads.googleads.v23.services.GoogleAdsServiceClient.SearchPagedResponse;
+import com.google.ads.googleads.v23.services.MutateCustomerClientLinkResponse;
+import com.google.ads.googleads.v23.services.MutateCustomerManagerLinkResponse;
+import com.google.ads.googleads.v23.utils.ResourceNames;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 import java.util.Arrays;

google-ads-examples/src/main/java/com/google/ads/googleads/examples/accountmanagement/ListAccessibleCustomers.java

@@ -15,11 +15,11 @@
 package com.google.ads.googleads.examples.accountmanagement;
 
 import com.google.ads.googleads.lib.GoogleAdsClient;
-import com.google.ads.googleads.v22.errors.GoogleAdsError;
-import com.google.ads.googleads.v22.errors.GoogleAdsException;
-import com.google.ads.googleads.v22.services.CustomerServiceClient;
-import com.google.ads.googleads.v22.services.ListAccessibleCustomersRequest;
-import com.google.ads.googleads.v22.services.ListAccessibleCustomersResponse;
+import com.google.ads.googleads.v23.errors.GoogleAdsError;
+import com.google.ads.googleads.v23.errors.GoogleAdsException;
+import com.google.ads.googleads.v23.services.CustomerServiceClient;
+import com.google.ads.googleads.v23.services.ListAccessibleCustomersRequest;
+import com.google.ads.googleads.v23.services.ListAccessibleCustomersResponse;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 

google-ads-examples/src/main/java/com/google/ads/googleads/examples/accountmanagement/UpdateUserAccess.java

@@ -19,17 +19,17 @@
 import com.google.ads.googleads.examples.utils.CodeSampleParams;
 import com.google.ads.googleads.lib.GoogleAdsClient;
 import com.google.ads.googleads.lib.utils.FieldMasks;
-import com.google.ads.googleads.v22.enums.AccessRoleEnum.AccessRole;
-import com.google.ads.googleads.v22.errors.GoogleAdsError;
-import com.google.ads.googleads.v22.errors.GoogleAdsException;
-import com.google.ads.googleads.v22.resources.CustomerUserAccess;
-import com.google.ads.googleads.v22.services.CustomerUserAccessOperation;
-import com.google.ads.googleads.v22.services.CustomerUserAccessServiceClient;
-import com.google.ads.googleads.v22.services.GoogleAdsRow;
-import com.google.ads.googleads.v22.services.GoogleAdsServiceClient;
-import com.google.ads.googleads.v22.services.GoogleAdsServiceClient.SearchPagedResponse;
-import com.google.ads.googleads.v22.services.MutateCustomerUserAccessResponse;
-import com.google.ads.googleads.v22.utils.ResourceNames;
+import com.google.ads.googleads.v23.enums.AccessRoleEnum.AccessRole;
+import com.google.ads.googleads.v23.errors.GoogleAdsError;
+import com.google.ads.googleads.v23.errors.GoogleAdsException;
+import com.google.ads.googleads.v23.resources.CustomerUserAccess;
+import com.google.ads.googleads.v23.services.CustomerUserAccessOperation;
+import com.google.ads.googleads.v23.services.CustomerUserAccessServiceClient;
+import com.google.ads.googleads.v23.services.GoogleAdsRow;
+import com.google.ads.googleads.v23.services.GoogleAdsServiceClient;
+import com.google.ads.googleads.v23.services.GoogleAdsServiceClient.SearchPagedResponse;
+import com.google.ads.googleads.v23.services.MutateCustomerUserAccessResponse;
+import com.google.ads.googleads.v23.utils.ResourceNames;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 import java.util.Iterator;

google-ads-examples/src/main/java/com/google/ads/googleads/examples/accountmanagement/VerifyAdvertiserIdentity.java

@@ -18,14 +18,14 @@
 import com.google.ads.googleads.examples.utils.ArgumentNames;
 import com.google.ads.googleads.examples.utils.CodeSampleParams;
 import com.google.ads.googleads.lib.GoogleAdsClient;
-import com.google.ads.googleads.v22.enums.IdentityVerificationProgramEnum.IdentityVerificationProgram;
-import com.google.ads.googleads.v22.enums.IdentityVerificationProgramStatusEnum.IdentityVerificationProgramStatus;
-import com.google.ads.googleads.v22.errors.GoogleAdsError;
-import com.google.ads.googleads.v22.errors.GoogleAdsException;
-import com.google.ads.googleads.v22.services.GetIdentityVerificationResponse;
-import com.google.ads.googleads.v22.services.IdentityVerification;
-import com.google.ads.googleads.v22.services.IdentityVerificationProgress;
-import com.google.ads.googleads.v22.services.IdentityVerificationServiceClient;
+import com.google.ads.googleads.v23.enums.IdentityVerificationProgramEnum.IdentityVerificationProgram;
+import com.google.ads.googleads.v23.enums.IdentityVerificationProgramStatusEnum.IdentityVerificationProgramStatus;
+import com.google.ads.googleads.v23.errors.GoogleAdsError;
+import com.google.ads.googleads.v23.errors.GoogleAdsException;
+import com.google.ads.googleads.v23.services.GetIdentityVerificationResponse;
+import com.google.ads.googleads.v23.services.IdentityVerification;
+import com.google.ads.googleads.v23.services.IdentityVerificationProgress;
+import com.google.ads.googleads.v23.services.IdentityVerificationServiceClient;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 

google-ads-examples/src/main/java/com/google/ads/googleads/examples/advancedoperations/AddAdCustomizer.java

@@ -20,29 +20,29 @@
 import com.google.ads.googleads.examples.utils.ArgumentNames;
 import com.google.ads.googleads.examples.utils.CodeSampleParams;
 import com.google.ads.googleads.lib.GoogleAdsClient;
-import com.google.ads.googleads.v22.common.AdTextAsset;
-import com.google.ads.googleads.v22.common.CustomizerValue;
-import com.google.ads.googleads.v22.common.ResponsiveSearchAdInfo;
-import com.google.ads.googleads.v22.enums.CustomizerAttributeTypeEnum.CustomizerAttributeType;
-import com.google.ads.googleads.v22.enums.ServedAssetFieldTypeEnum.ServedAssetFieldType;
-import com.google.ads.googleads.v22.errors.GoogleAdsError;
-import com.google.ads.googleads.v22.errors.GoogleAdsException;
-import com.google.ads.googleads.v22.resources.Ad;
-import com.google.ads.googleads.v22.resources.AdGroupAd;
-import com.google.ads.googleads.v22.resources.AdGroupCustomizer;
-import com.google.ads.googleads.v22.resources.CustomizerAttribute;
-import com.google.ads.googleads.v22.services.AdGroupAdOperation;
-import com.google.ads.googleads.v22.services.AdGroupAdServiceClient;
-import com.google.ads.googleads.v22.services.AdGroupCustomizerOperation;
-import com.google.ads.googleads.v22.services.AdGroupCustomizerServiceClient;
-import com.google.ads.googleads.v22.services.CustomizerAttributeOperation;
-import com.google.ads.googleads.v22.services.CustomizerAttributeServiceClient;
-import com.google.ads.googleads.v22.services.MutateAdGroupAdResult;
-import com.google.ads.googleads.v22.services.MutateAdGroupAdsResponse;
-import com.google.ads.googleads.v22.services.MutateAdGroupCustomizerResult;
-import com.google.ads.googleads.v22.services.MutateAdGroupCustomizersResponse;
-import com.google.ads.googleads.v22.services.MutateCustomizerAttributesResponse;
-import com.google.ads.googleads.v22.utils.ResourceNames;
+import com.google.ads.googleads.v23.common.AdTextAsset;
+import com.google.ads.googleads.v23.common.CustomizerValue;
+import com.google.ads.googleads.v23.common.ResponsiveSearchAdInfo;
+import com.google.ads.googleads.v23.enums.CustomizerAttributeTypeEnum.CustomizerAttributeType;
+import com.google.ads.googleads.v23.enums.ServedAssetFieldTypeEnum.ServedAssetFieldType;
+import com.google.ads.googleads.v23.errors.GoogleAdsError;
+import com.google.ads.googleads.v23.errors.GoogleAdsException;
+import com.google.ads.googleads.v23.resources.Ad;
+import com.google.ads.googleads.v23.resources.AdGroupAd;
+import com.google.ads.googleads.v23.resources.AdGroupCustomizer;
+import com.google.ads.googleads.v23.resources.CustomizerAttribute;
+import com.google.ads.googleads.v23.services.AdGroupAdOperation;
+import com.google.ads.googleads.v23.services.AdGroupAdServiceClient;
+import com.google.ads.googleads.v23.services.AdGroupCustomizerOperation;
+import com.google.ads.googleads.v23.services.AdGroupCustomizerServiceClient;
+import com.google.ads.googleads.v23.services.CustomizerAttributeOperation;
+import com.google.ads.googleads.v23.services.CustomizerAttributeServiceClient;
+import com.google.ads.googleads.v23.services.MutateAdGroupAdResult;
+import com.google.ads.googleads.v23.services.MutateAdGroupAdsResponse;
+import com.google.ads.googleads.v23.services.MutateAdGroupCustomizerResult;
+import com.google.ads.googleads.v23.services.MutateAdGroupCustomizersResponse;
+import com.google.ads.googleads.v23.services.MutateCustomizerAttributesResponse;
+import com.google.ads.googleads.v23.utils.ResourceNames;
 import com.google.common.collect.ImmutableList;
 import java.io.FileNotFoundException;
 import java.io.IOException;