Changes for release v19_0.

Author: sarahcaseybot

CHANGELOG.md

@@ -1,3 +1,14 @@
+36.0.0 - 2025-02-27
+-------------------
+- Add support and examples for Google Ads API v19.
+- Remove all uses of feeds.
+- Updated shoppingads/AddShoppingProductAd to remove usage of deprecated
+  enhancedCpc bidding strategy.
+- Updated shoppingads/AddPerformanceMaxRetailCampaign and
+  advancedoperations/AddPerformanceMaxCampaign examples to include brand
+  guidelines.
+- Update to version 3.44.0 of `google-cloud-shared-dependencies`.
+
 35.0.0 - 2025-01-27
 -------------------
 - Remove support for v16 of the Google Ads API.

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

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

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

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.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 com.google.ads.googleads.v19.errors.GoogleAdsError;
+import com.google.ads.googleads.v19.errors.GoogleAdsException;
+import com.google.ads.googleads.v19.resources.Customer;
+import com.google.ads.googleads.v19.services.CreateCustomerClientResponse;
+import com.google.ads.googleads.v19.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.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.ads.googleads.v19.errors.GoogleAdsError;
+import com.google.ads.googleads.v19.errors.GoogleAdsException;
+import com.google.ads.googleads.v19.resources.CustomerClient;
+import com.google.ads.googleads.v19.resources.CustomerName;
+import com.google.ads.googleads.v19.services.CustomerServiceClient;
+import com.google.ads.googleads.v19.services.GoogleAdsRow;
+import com.google.ads.googleads.v19.services.GoogleAdsServiceClient;
+import com.google.ads.googleads.v19.services.GoogleAdsServiceClient.SearchPagedResponse;
+import com.google.ads.googleads.v19.services.ListAccessibleCustomersRequest;
+import com.google.ads.googleads.v19.services.ListAccessibleCustomersResponse;
+import com.google.ads.googleads.v19.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.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.ads.googleads.v19.enums.ChangeEventResourceTypeEnum.ChangeEventResourceType;
+import com.google.ads.googleads.v19.enums.ResourceChangeOperationEnum.ResourceChangeOperation;
+import com.google.ads.googleads.v19.errors.GoogleAdsError;
+import com.google.ads.googleads.v19.errors.GoogleAdsException;
+import com.google.ads.googleads.v19.resources.ChangeEvent;
+import com.google.ads.googleads.v19.resources.ChangeEvent.ChangedResource;
+import com.google.ads.googleads.v19.services.GoogleAdsRow;
+import com.google.ads.googleads.v19.services.GoogleAdsServiceClient;
+import com.google.ads.googleads.v19.services.GoogleAdsServiceClient.SearchPagedResponse;
 import com.google.protobuf.Message;
 import java.io.FileNotFoundException;
 import java.io.IOException;
@@ -201,14 +201,6 @@ private Optional<Message> getResourceByType(
         return Optional.of(resource.getCampaignCriterion());
       case CUSTOMER_ASSET:
         return Optional.of(resource.getCustomerAsset());
-      case AD_GROUP_FEED:
-        return Optional.of(resource.getAdGroupFeed());
-      case CAMPAIGN_FEED:
-        return Optional.of(resource.getCampaignFeed());
-      case FEED:
-        return Optional.of(resource.getFeed());
-      case FEED_ITEM:
-        return Optional.of(resource.getFeedItem());
       default:
         System.out.println("Unknown entity type: " + type);
         return Optional.empty();

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.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 com.google.ads.googleads.v19.errors.GoogleAdsError;
+import com.google.ads.googleads.v19.errors.GoogleAdsException;
+import com.google.ads.googleads.v19.resources.ChangeStatus;
+import com.google.ads.googleads.v19.services.GoogleAdsRow;
+import com.google.ads.googleads.v19.services.GoogleAdsServiceClient;
+import com.google.ads.googleads.v19.services.GoogleAdsServiceClient.SearchPagedResponse;
 import java.io.FileNotFoundException;
 import java.io.IOException;
 import java.util.Optional;
@@ -93,12 +93,8 @@ private void runExample(GoogleAdsClient googleAdsClient, long customerId) {
             + "change_status.ad_group_ad, "
             + "change_status.ad_group_bid_modifier, "
             + "change_status.ad_group_criterion, "
-            + "change_status.ad_group_feed, "
             + "change_status.campaign, "
             + "change_status.campaign_criterion, "
-            + "change_status.campaign_feed, "
-            + "change_status.feed, "
-            + "change_status.feed_item "
             + "FROM change_status "
             + "WHERE change_status.last_change_date_time DURING LAST_14_DAYS "
             + "ORDER BY change_status.last_change_date_time "
@@ -150,24 +146,12 @@ private static Optional<String> getResourceNameForResourceType(ChangeStatus chan
       case AD_GROUP_CRITERION:
         resourceName = changeStatus.getAdGroupCriterion();
         break;
-      case AD_GROUP_FEED:
-        resourceName = changeStatus.getAdGroupFeed();
-        break;
       case CAMPAIGN:
         resourceName = changeStatus.getCampaign();
         break;
       case CAMPAIGN_CRITERION:
         resourceName = changeStatus.getCampaignCriterion();
         break;
-      case CAMPAIGN_FEED:
-        resourceName = changeStatus.getCampaignFeed();
-        break;
-      case FEED:
-        resourceName = changeStatus.getFeed();
-        break;
-      case FEED_ITEM:
-        resourceName = changeStatus.getFeedItem();
-        break;
     }
     return Optional.ofNullable(resourceName);
   }

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.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 com.google.ads.googleads.v19.enums.AccessRoleEnum.AccessRole;
+import com.google.ads.googleads.v19.errors.GoogleAdsError;
+import com.google.ads.googleads.v19.errors.GoogleAdsException;
+import com.google.ads.googleads.v19.resources.CustomerUserAccessInvitation;
+import com.google.ads.googleads.v19.services.CustomerUserAccessInvitationOperation;
+import com.google.ads.googleads.v19.services.CustomerUserAccessInvitationServiceClient;
+import com.google.ads.googleads.v19.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.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 com.google.ads.googleads.v19.enums.ManagerLinkStatusEnum.ManagerLinkStatus;
+import com.google.ads.googleads.v19.errors.GoogleAdsError;
+import com.google.ads.googleads.v19.errors.GoogleAdsException;
+import com.google.ads.googleads.v19.services.CustomerClientLinkOperation;
+import com.google.ads.googleads.v19.services.CustomerClientLinkServiceClient;
+import com.google.ads.googleads.v19.services.CustomerManagerLinkOperation;
+import com.google.ads.googleads.v19.services.CustomerManagerLinkServiceClient;
+import com.google.ads.googleads.v19.services.GoogleAdsRow;
+import com.google.ads.googleads.v19.services.GoogleAdsServiceClient;
+import com.google.ads.googleads.v19.services.GoogleAdsServiceClient.SearchPagedResponse;
+import com.google.ads.googleads.v19.services.MutateCustomerClientLinkResponse;
+import com.google.ads.googleads.v19.services.MutateCustomerManagerLinkResponse;
+import com.google.ads.googleads.v19.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.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 com.google.ads.googleads.v19.errors.GoogleAdsError;
+import com.google.ads.googleads.v19.errors.GoogleAdsException;
+import com.google.ads.googleads.v19.services.CustomerServiceClient;
+import com.google.ads.googleads.v19.services.ListAccessibleCustomersRequest;
+import com.google.ads.googleads.v19.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.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 com.google.ads.googleads.v19.enums.AccessRoleEnum.AccessRole;
+import com.google.ads.googleads.v19.errors.GoogleAdsError;
+import com.google.ads.googleads.v19.errors.GoogleAdsException;
+import com.google.ads.googleads.v19.resources.CustomerUserAccess;
+import com.google.ads.googleads.v19.services.CustomerUserAccessOperation;
+import com.google.ads.googleads.v19.services.CustomerUserAccessServiceClient;
+import com.google.ads.googleads.v19.services.GoogleAdsRow;
+import com.google.ads.googleads.v19.services.GoogleAdsServiceClient;
+import com.google.ads.googleads.v19.services.GoogleAdsServiceClient.SearchPagedResponse;
+import com.google.ads.googleads.v19.services.MutateCustomerUserAccessResponse;
+import com.google.ads.googleads.v19.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.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 com.google.ads.googleads.v19.enums.IdentityVerificationProgramEnum.IdentityVerificationProgram;
+import com.google.ads.googleads.v19.enums.IdentityVerificationProgramStatusEnum.IdentityVerificationProgramStatus;
+import com.google.ads.googleads.v19.errors.GoogleAdsError;
+import com.google.ads.googleads.v19.errors.GoogleAdsException;
+import com.google.ads.googleads.v19.services.GetIdentityVerificationResponse;
+import com.google.ads.googleads.v19.services.IdentityVerification;
+import com.google.ads.googleads.v19.services.IdentityVerificationProgress;
+import com.google.ads.googleads.v19.services.IdentityVerificationServiceClient;
 import java.io.FileNotFoundException;
 import java.io.IOException;