Changes for release v22. (#861)

Author: sarahcaseybot

CHANGELOG.md

@@ -1,3 +1,9 @@
+41.0.0 - 2025-10-15
+-------------------
+- Add support and examples for v22 of the Google Ads API.
+- Updated the AddPerformanceMaxCampaign and AddPerformanceMaxRetailCampaign
+  examples to set available asset automation settings.
+
 40.0.0 - 2025-09-03
 -------------------
 - Add the google-ads-bom module to assist users with dependency management.

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>40.0.0</version>
+      <version>41.0.0</version>
     </dependency>
 
 ## Gradle dependency
 
-    implementation 'com.google.api-ads:google-ads:40.0.0'
+    implementation 'com.google.api-ads:google-ads:41.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.50.2')
+  api platform('com.google.cloud:google-cloud-shared-dependencies:3.52.2')
   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,7 +126,7 @@ 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.65.0"))
+    api(platform("com.google.cloud:libraries-bom:26.69.0"))
 
     // Add constraints for all of this project's artifacts.
     constraints {

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.v21.errors.GoogleAdsError;
-import com.google.ads.googleads.v21.errors.GoogleAdsException;
-import com.google.ads.googleads.v21.resources.Customer;
-import com.google.ads.googleads.v21.services.CreateCustomerClientResponse;
-import com.google.ads.googleads.v21.services.CustomerServiceClient;
+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 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.v21.errors.GoogleAdsError;
-import com.google.ads.googleads.v21.errors.GoogleAdsException;
-import com.google.ads.googleads.v21.resources.CustomerClient;
-import com.google.ads.googleads.v21.resources.CustomerName;
-import com.google.ads.googleads.v21.services.CustomerServiceClient;
-import com.google.ads.googleads.v21.services.GoogleAdsRow;
-import com.google.ads.googleads.v21.services.GoogleAdsServiceClient;
-import com.google.ads.googleads.v21.services.GoogleAdsServiceClient.SearchPagedResponse;
-import com.google.ads.googleads.v21.services.ListAccessibleCustomersRequest;
-import com.google.ads.googleads.v21.services.ListAccessibleCustomersResponse;
-import com.google.ads.googleads.v21.services.SearchGoogleAdsRequest;
+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.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.v21.enums.ChangeEventResourceTypeEnum.ChangeEventResourceType;
-import com.google.ads.googleads.v21.enums.ResourceChangeOperationEnum.ResourceChangeOperation;
-import com.google.ads.googleads.v21.errors.GoogleAdsError;
-import com.google.ads.googleads.v21.errors.GoogleAdsException;
-import com.google.ads.googleads.v21.resources.ChangeEvent;
-import com.google.ads.googleads.v21.resources.ChangeEvent.ChangedResource;
-import com.google.ads.googleads.v21.services.GoogleAdsRow;
-import com.google.ads.googleads.v21.services.GoogleAdsServiceClient;
-import com.google.ads.googleads.v21.services.GoogleAdsServiceClient.SearchPagedResponse;
+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.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.v21.errors.GoogleAdsError;
-import com.google.ads.googleads.v21.errors.GoogleAdsException;
-import com.google.ads.googleads.v21.resources.ChangeStatus;
-import com.google.ads.googleads.v21.services.GoogleAdsRow;
-import com.google.ads.googleads.v21.services.GoogleAdsServiceClient;
-import com.google.ads.googleads.v21.services.GoogleAdsServiceClient.SearchPagedResponse;
+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 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.v21.enums.AccessRoleEnum.AccessRole;
-import com.google.ads.googleads.v21.errors.GoogleAdsError;
-import com.google.ads.googleads.v21.errors.GoogleAdsException;
-import com.google.ads.googleads.v21.resources.CustomerUserAccessInvitation;
-import com.google.ads.googleads.v21.services.CustomerUserAccessInvitationOperation;
-import com.google.ads.googleads.v21.services.CustomerUserAccessInvitationServiceClient;
-import com.google.ads.googleads.v21.services.MutateCustomerUserAccessInvitationResponse;
+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 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.v21.enums.ManagerLinkStatusEnum.ManagerLinkStatus;
-import com.google.ads.googleads.v21.errors.GoogleAdsError;
-import com.google.ads.googleads.v21.errors.GoogleAdsException;
-import com.google.ads.googleads.v21.services.CustomerClientLinkOperation;
-import com.google.ads.googleads.v21.services.CustomerClientLinkServiceClient;
-import com.google.ads.googleads.v21.services.CustomerManagerLinkOperation;
-import com.google.ads.googleads.v21.services.CustomerManagerLinkServiceClient;
-import com.google.ads.googleads.v21.services.GoogleAdsRow;
-import com.google.ads.googleads.v21.services.GoogleAdsServiceClient;
-import com.google.ads.googleads.v21.services.GoogleAdsServiceClient.SearchPagedResponse;
-import com.google.ads.googleads.v21.services.MutateCustomerClientLinkResponse;
-import com.google.ads.googleads.v21.services.MutateCustomerManagerLinkResponse;
-import com.google.ads.googleads.v21.utils.ResourceNames;
+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 java.io.FileNotFoundException;
 import java.io.IOException;
 import java.util.Arrays;