Changes for release v17_0. (#798)

Author: jradcliff

CHANGELOG.md

@@ -1,3 +1,14 @@
+32.0.0 - 2024-06-06
+-------------------
+- Add support and examples for Google Ads API v17.
+- Update to version 3.30.1 of
+  `google-cloud-shared-dependencies`.
+- Remove usage of page size from search samples.
+
+Compatible with [Google Cloud Libraries Bill of Materials
+(BOM)](https://cloud.google.com/java/docs/bom) release
+`com.google.cloud:libraries-bom:26.40.0`.
+
 31.0.0 - 2024-02-25
 -------------------
 - Add support and examples for Google Ads API v16.1.

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>31.0.0</version>
+      <version>32.0.0</version>
     </dependency>
 
 ## Gradle dependency
 
-    implementation 'com.google.api-ads:google-ads:31.0.0'
+    implementation 'com.google.api-ads:google-ads:32.0.0'
 
 ## Documentation
 

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

@@ -186,7 +186,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.29.0')
+  api platform('com.google.cloud:google-cloud-shared-dependencies:3.30.1')
   implementation 'com.google.guava:guava'
   implementation 'com.google.auto.service:auto-service:1.0.1'
   implementation 'javax.annotation:javax.annotation-api'

google-ads-examples/build.gradle

@@ -42,7 +42,6 @@ plugins {
 
 dependencies {
   implementation project(':google-ads')
-  implementation 'org.apache.commons:commons-lang3:3.11'
   implementation 'com.beust:jcommander:1.72'
   implementation 'joda-time:joda-time:2.8.2'
   runtimeOnly 'org.apache.logging.log4j:log4j-slf4j-impl:2.16.0'

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