Changes for release v18_0. (#812)

googleads · Oct 17, 2024 · 9d93370 · 9d93370
1 parent 30dbae2
commit 9d93370
Show file tree

Hide file tree

Showing 6,146 changed files with 2,687,283 additions and 3,556 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,3 +1,14 @@
+34.0.0 - 2024-10-17
+-------------------
+- Add support and examples for Google Ads API v18.
+- Updated campaignmanagement/GetAllDisapprovedAds example to use the new
+  `SearchSettings` object.
+- Update to version 3.35.0 of `google-cloud-shared-dependencies`.
+
+Compatible with [Google Cloud Libraries Bill of Materials
+(BOM)](https://cloud.google.com/java/docs/bom) release
+`com.google.cloud:libraries-bom:26.46.0`.
+
 33.0.0 - 2024-08-08
 -------------------
 - Add support and examples for Google Ads API v17.1.

diff --git a/README.md b/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>33.0.0</version>
+      <version>34.0.0</version>
     </dependency>
 
 ## Gradle dependency
 
-    implementation 'com.google.api-ads:google-ads:33.0.0'
+    implementation 'com.google.api-ads:google-ads:34.0.0'
 
 ## Documentation
 

diff --git a/buildSrc/src/main/groovy/com.google.api-ads.java-conventions.gradle b/buildSrc/src/main/groovy/com.google.api-ads.java-conventions.gradle
@@ -107,6 +107,9 @@ publishing {
   }
 }
 
+// Deactivates publishing of test fixtures. Test fixtures are an implementation/testing
+// detail that's not needed by users of the published library.
+// https://docs.gradle.org/7.6.2/userguide/java_testing.html#publishing_test_fixtures
 components.java.withVariantsFromConfiguration(configurations.testFixturesApiElements) { skip() }
 components.java.withVariantsFromConfiguration(configurations.testFixturesRuntimeElements) { skip() }
 
@@ -186,7 +189,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.33.0')
+  api platform('com.google.cloud:google-cloud-shared-dependencies:3.35.0')
   implementation 'com.google.guava:guava'
   implementation 'com.google.auto.service:auto-service:1.0.1'
   implementation 'javax.annotation:javax.annotation-api'

diff --git a/...les/src/main/java/com/google/ads/googleads/examples/accountmanagement/CreateCustomer.java b/...les/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.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 com.google.ads.googleads.v18.errors.GoogleAdsError;
+import com.google.ads.googleads.v18.errors.GoogleAdsException;
+import com.google.ads.googleads.v18.resources.Customer;
+import com.google.ads.googleads.v18.services.CreateCustomerClientResponse;
+import com.google.ads.googleads.v18.services.CustomerServiceClient;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 import java.time.ZonedDateTime;

diff --git a/...rc/main/java/com/google/ads/googleads/examples/accountmanagement/GetAccountHierarchy.java b/...rc/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.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.ads.googleads.v18.errors.GoogleAdsError;
+import com.google.ads.googleads.v18.errors.GoogleAdsException;
+import com.google.ads.googleads.v18.resources.CustomerClient;
+import com.google.ads.googleads.v18.resources.CustomerName;
+import com.google.ads.googleads.v18.services.CustomerServiceClient;
+import com.google.ads.googleads.v18.services.GoogleAdsRow;
+import com.google.ads.googleads.v18.services.GoogleAdsServiceClient;
+import com.google.ads.googleads.v18.services.GoogleAdsServiceClient.SearchPagedResponse;
+import com.google.ads.googleads.v18.services.ListAccessibleCustomersRequest;
+import com.google.ads.googleads.v18.services.ListAccessibleCustomersResponse;
+import com.google.ads.googleads.v18.services.SearchGoogleAdsRequest;
 import com.google.common.base.Strings;
 import com.google.common.collect.ArrayListMultimap;
 import com.google.common.collect.Multimap;

diff --git a/...s/src/main/java/com/google/ads/googleads/examples/accountmanagement/GetChangeDetails.java b/...s/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.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.ads.googleads.v18.enums.ChangeEventResourceTypeEnum.ChangeEventResourceType;
+import com.google.ads.googleads.v18.enums.ResourceChangeOperationEnum.ResourceChangeOperation;
+import com.google.ads.googleads.v18.errors.GoogleAdsError;
+import com.google.ads.googleads.v18.errors.GoogleAdsException;
+import com.google.ads.googleads.v18.resources.ChangeEvent;
+import com.google.ads.googleads.v18.resources.ChangeEvent.ChangedResource;
+import com.google.ads.googleads.v18.services.GoogleAdsRow;
+import com.google.ads.googleads.v18.services.GoogleAdsServiceClient;
+import com.google.ads.googleads.v18.services.GoogleAdsServiceClient.SearchPagedResponse;
 import com.google.protobuf.Message;
 import java.io.FileNotFoundException;
 import java.io.IOException;

diff --git a/...s/src/main/java/com/google/ads/googleads/examples/accountmanagement/GetChangeSummary.java b/...s/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.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 com.google.ads.googleads.v18.errors.GoogleAdsError;
+import com.google.ads.googleads.v18.errors.GoogleAdsException;
+import com.google.ads.googleads.v18.resources.ChangeStatus;
+import com.google.ads.googleads.v18.services.GoogleAdsRow;
+import com.google.ads.googleads.v18.services.GoogleAdsServiceClient;
+import com.google.ads.googleads.v18.services.GoogleAdsServiceClient.SearchPagedResponse;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 import java.util.Optional;

diff --git a/...in/java/com/google/ads/googleads/examples/accountmanagement/InviteUserWithAccessRole.java b/...in/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.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 com.google.ads.googleads.v18.enums.AccessRoleEnum.AccessRole;
+import com.google.ads.googleads.v18.errors.GoogleAdsError;
+import com.google.ads.googleads.v18.errors.GoogleAdsException;
+import com.google.ads.googleads.v18.resources.CustomerUserAccessInvitation;
+import com.google.ads.googleads.v18.services.CustomerUserAccessInvitationOperation;
+import com.google.ads.googleads.v18.services.CustomerUserAccessInvitationServiceClient;
+import com.google.ads.googleads.v18.services.MutateCustomerUserAccessInvitationResponse;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 

diff --git a/...rc/main/java/com/google/ads/googleads/examples/accountmanagement/LinkManagerToClient.java b/...rc/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.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 com.google.ads.googleads.v18.enums.ManagerLinkStatusEnum.ManagerLinkStatus;
+import com.google.ads.googleads.v18.errors.GoogleAdsError;
+import com.google.ads.googleads.v18.errors.GoogleAdsException;
+import com.google.ads.googleads.v18.services.CustomerClientLinkOperation;
+import com.google.ads.googleads.v18.services.CustomerClientLinkServiceClient;
+import com.google.ads.googleads.v18.services.CustomerManagerLinkOperation;
+import com.google.ads.googleads.v18.services.CustomerManagerLinkServiceClient;
+import com.google.ads.googleads.v18.services.GoogleAdsRow;
+import com.google.ads.googleads.v18.services.GoogleAdsServiceClient;
+import com.google.ads.googleads.v18.services.GoogleAdsServiceClient.SearchPagedResponse;
+import com.google.ads.googleads.v18.services.MutateCustomerClientLinkResponse;
+import com.google.ads.googleads.v18.services.MutateCustomerManagerLinkResponse;
+import com.google.ads.googleads.v18.utils.ResourceNames;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 import java.util.Arrays;

diff --git a/...ain/java/com/google/ads/googleads/examples/accountmanagement/ListAccessibleCustomers.java b/...ain/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.v17.errors.GoogleAdsError;
-import com.google.ads.googleads.v17.errors.GoogleAdsException;
-import com.google.ads.googleads.v17.services.CustomerServiceClient;
-import com.google.ads.googleads.v17.services.ListAccessibleCustomersRequest;
-import com.google.ads.googleads.v17.services.ListAccessibleCustomersResponse;
+import com.google.ads.googleads.v18.errors.GoogleAdsError;
+import com.google.ads.googleads.v18.errors.GoogleAdsException;
+import com.google.ads.googleads.v18.services.CustomerServiceClient;
+import com.google.ads.googleads.v18.services.ListAccessibleCustomersRequest;
+import com.google.ads.googleads.v18.services.ListAccessibleCustomersResponse;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 

diff --git a/...s/src/main/java/com/google/ads/googleads/examples/accountmanagement/UpdateUserAccess.java b/...s/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.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.CustomerUserAccess;
-import com.google.ads.googleads.v17.services.CustomerUserAccessOperation;
-import com.google.ads.googleads.v17.services.CustomerUserAccessServiceClient;
-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.MutateCustomerUserAccessResponse;
-import com.google.ads.googleads.v17.utils.ResourceNames;
+import com.google.ads.googleads.v18.enums.AccessRoleEnum.AccessRole;
+import com.google.ads.googleads.v18.errors.GoogleAdsError;
+import com.google.ads.googleads.v18.errors.GoogleAdsException;
+import com.google.ads.googleads.v18.resources.CustomerUserAccess;
+import com.google.ads.googleads.v18.services.CustomerUserAccessOperation;
+import com.google.ads.googleads.v18.services.CustomerUserAccessServiceClient;
+import com.google.ads.googleads.v18.services.GoogleAdsRow;
+import com.google.ads.googleads.v18.services.GoogleAdsServiceClient;
+import com.google.ads.googleads.v18.services.GoogleAdsServiceClient.SearchPagedResponse;
+import com.google.ads.googleads.v18.services.MutateCustomerUserAccessResponse;
+import com.google.ads.googleads.v18.utils.ResourceNames;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 import java.util.Iterator;

diff --git a/...in/java/com/google/ads/googleads/examples/accountmanagement/VerifyAdvertiserIdentity.java b/...in/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.v17.enums.IdentityVerificationProgramEnum.IdentityVerificationProgram;
-import com.google.ads.googleads.v17.enums.IdentityVerificationProgramStatusEnum.IdentityVerificationProgramStatus;
-import com.google.ads.googleads.v17.errors.GoogleAdsError;
-import com.google.ads.googleads.v17.errors.GoogleAdsException;
-import com.google.ads.googleads.v17.services.GetIdentityVerificationResponse;
-import com.google.ads.googleads.v17.services.IdentityVerification;
-import com.google.ads.googleads.v17.services.IdentityVerificationProgress;
-import com.google.ads.googleads.v17.services.IdentityVerificationServiceClient;
+import com.google.ads.googleads.v18.enums.IdentityVerificationProgramEnum.IdentityVerificationProgram;
+import com.google.ads.googleads.v18.enums.IdentityVerificationProgramStatusEnum.IdentityVerificationProgramStatus;
+import com.google.ads.googleads.v18.errors.GoogleAdsError;
+import com.google.ads.googleads.v18.errors.GoogleAdsException;
+import com.google.ads.googleads.v18.services.GetIdentityVerificationResponse;
+import com.google.ads.googleads.v18.services.IdentityVerification;
+import com.google.ads.googleads.v18.services.IdentityVerificationProgress;
+import com.google.ads.googleads.v18.services.IdentityVerificationServiceClient;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 

diff --git a/...s/src/main/java/com/google/ads/googleads/examples/advancedoperations/AddAdCustomizer.java b/...s/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.v17.common.AdTextAsset;
-import com.google.ads.googleads.v17.common.CustomizerValue;
-import com.google.ads.googleads.v17.common.ResponsiveSearchAdInfo;
-import com.google.ads.googleads.v17.enums.CustomizerAttributeTypeEnum.CustomizerAttributeType;
-import com.google.ads.googleads.v17.enums.ServedAssetFieldTypeEnum.ServedAssetFieldType;
-import com.google.ads.googleads.v17.errors.GoogleAdsError;
-import com.google.ads.googleads.v17.errors.GoogleAdsException;
-import com.google.ads.googleads.v17.resources.Ad;
-import com.google.ads.googleads.v17.resources.AdGroupAd;
-import com.google.ads.googleads.v17.resources.AdGroupCustomizer;
-import com.google.ads.googleads.v17.resources.CustomizerAttribute;
-import com.google.ads.googleads.v17.services.AdGroupAdOperation;
-import com.google.ads.googleads.v17.services.AdGroupAdServiceClient;
-import com.google.ads.googleads.v17.services.AdGroupCustomizerOperation;
-import com.google.ads.googleads.v17.services.AdGroupCustomizerServiceClient;
-import com.google.ads.googleads.v17.services.CustomizerAttributeOperation;
-import com.google.ads.googleads.v17.services.CustomizerAttributeServiceClient;
-import com.google.ads.googleads.v17.services.MutateAdGroupAdResult;
-import com.google.ads.googleads.v17.services.MutateAdGroupAdsResponse;
-import com.google.ads.googleads.v17.services.MutateAdGroupCustomizerResult;
-import com.google.ads.googleads.v17.services.MutateAdGroupCustomizersResponse;
-import com.google.ads.googleads.v17.services.MutateCustomizerAttributesResponse;
-import com.google.ads.googleads.v17.utils.ResourceNames;
+import com.google.ads.googleads.v18.common.AdTextAsset;
+import com.google.ads.googleads.v18.common.CustomizerValue;
+import com.google.ads.googleads.v18.common.ResponsiveSearchAdInfo;
+import com.google.ads.googleads.v18.enums.CustomizerAttributeTypeEnum.CustomizerAttributeType;
+import com.google.ads.googleads.v18.enums.ServedAssetFieldTypeEnum.ServedAssetFieldType;
+import com.google.ads.googleads.v18.errors.GoogleAdsError;
+import com.google.ads.googleads.v18.errors.GoogleAdsException;
+import com.google.ads.googleads.v18.resources.Ad;
+import com.google.ads.googleads.v18.resources.AdGroupAd;
+import com.google.ads.googleads.v18.resources.AdGroupCustomizer;
+import com.google.ads.googleads.v18.resources.CustomizerAttribute;
+import com.google.ads.googleads.v18.services.AdGroupAdOperation;
+import com.google.ads.googleads.v18.services.AdGroupAdServiceClient;
+import com.google.ads.googleads.v18.services.AdGroupCustomizerOperation;
+import com.google.ads.googleads.v18.services.AdGroupCustomizerServiceClient;
+import com.google.ads.googleads.v18.services.CustomizerAttributeOperation;
+import com.google.ads.googleads.v18.services.CustomizerAttributeServiceClient;
+import com.google.ads.googleads.v18.services.MutateAdGroupAdResult;
+import com.google.ads.googleads.v18.services.MutateAdGroupAdsResponse;
+import com.google.ads.googleads.v18.services.MutateAdGroupCustomizerResult;
+import com.google.ads.googleads.v18.services.MutateAdGroupCustomizersResponse;
+import com.google.ads.googleads.v18.services.MutateCustomizerAttributesResponse;
+import com.google.ads.googleads.v18.utils.ResourceNames;
 import com.google.common.collect.ImmutableList;
 import java.io.FileNotFoundException;
 import java.io.IOException;