Changes for release v15.

.gitignore

@@ -50,3 +50,7 @@ google-ads/*/buildNumber.properties
 buildSrc/.gradle/
 */build/
 
+# VSCode build output and settings
+.vscode/
+*/bin/
+

CHANGELOG.md

@@ -1,3 +1,7 @@
+28.0.0 - 2023-10-19
+-------------------
+- Add support and examples for Google Ads API v15.
+
 27.0.0 - 2023-09-21
 -------------------
 - Remove support for v12 of 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>27.0.0</version>
+      <version>28.0.0</version>
     </dependency>
 
 ## Gradle dependency
 
-    implementation 'com.google.api-ads:google-ads:27.0.0'
+    implementation 'com.google.api-ads:google-ads:28.0.0'
 
 ## Documentation
 

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

@@ -40,6 +40,10 @@
  *
  * <p>To run this example, you must use the Merchant Center UI or the Content API for Shopping to
  * send a link request between your Merchant Center and Google Ads accounts.
+ *
+ * <p>This code example uses version v14 of the Google Ads API. Version v15 of the Google Ads API
+ * replaces MerchantCenterLinkService with ProductLinkInvitationService and ProductLinkService. We
+ * will add new code examples using these services shortly.
  */
 public class ApproveMerchantCenterLink {
 
@@ -107,7 +111,7 @@ private void runExample(
     // Approves a pending link request for a Google Ads account with customerId from a Merchant
     // Center account with merchantCenterAccountId.
     try (MerchantCenterLinkServiceClient merchantCenterLinkService =
-        googleAdsClient.getLatestVersion().createMerchantCenterLinkServiceClient()) {
+        googleAdsClient.getVersion14().createMerchantCenterLinkServiceClient()) {
       // [START approve_merchant_center_link]
       ListMerchantCenterLinksResponse response =
           merchantCenterLinkService.listMerchantCenterLinks(

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

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

@@ -38,6 +38,10 @@
  *
  * <p>To run this example, you must use the Merchant Center UI or the Content API for Shopping to
  * send a link request between your Merchant Center and Google Ads accounts.
+ *
+ * <p>This code example uses version v14 of the Google Ads API. Version v15 of the Google Ads API
+ * replaces MerchantCenterLinkService with ProductLinkInvitationService and ProductLinkService. We
+ * will add new code examples using these services shortly.
  */
 public class RejectMerchantCenterLink {
 
@@ -105,7 +109,7 @@ private void runExample(
     // Rejects a pending link request or unlinks an enabled link for a Google Ads account with
     // customerId from a Merchant Center account with merchantCenterAccountId.
     try (MerchantCenterLinkServiceClient merchantCenterLinkService =
-        googleAdsClient.getLatestVersion().createMerchantCenterLinkServiceClient()) {
+        googleAdsClient.getVersion14().createMerchantCenterLinkServiceClient()) {
       ListMerchantCenterLinksResponse response =
           merchantCenterLinkService.listMerchantCenterLinks(
               ListMerchantCenterLinksRequest.newBuilder()

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.v14.enums.AccessRoleEnum.AccessRole;
-import com.google.ads.googleads.v14.errors.GoogleAdsError;
-import com.google.ads.googleads.v14.errors.GoogleAdsException;
-import com.google.ads.googleads.v14.resources.CustomerUserAccess;
-import com.google.ads.googleads.v14.services.CustomerUserAccessOperation;
-import com.google.ads.googleads.v14.services.CustomerUserAccessServiceClient;
-import com.google.ads.googleads.v14.services.GoogleAdsRow;
-import com.google.ads.googleads.v14.services.GoogleAdsServiceClient;
-import com.google.ads.googleads.v14.services.GoogleAdsServiceClient.SearchPagedResponse;
-import com.google.ads.googleads.v14.services.MutateCustomerUserAccessResponse;
-import com.google.ads.googleads.v14.utils.ResourceNames;
+import com.google.ads.googleads.v15.enums.AccessRoleEnum.AccessRole;
+import com.google.ads.googleads.v15.errors.GoogleAdsError;
+import com.google.ads.googleads.v15.errors.GoogleAdsException;
+import com.google.ads.googleads.v15.resources.CustomerUserAccess;
+import com.google.ads.googleads.v15.services.CustomerUserAccessOperation;
+import com.google.ads.googleads.v15.services.CustomerUserAccessServiceClient;
+import com.google.ads.googleads.v15.services.GoogleAdsRow;
+import com.google.ads.googleads.v15.services.GoogleAdsServiceClient;
+import com.google.ads.googleads.v15.services.GoogleAdsServiceClient.SearchPagedResponse;
+import com.google.ads.googleads.v15.services.MutateCustomerUserAccessResponse;
+import com.google.ads.googleads.v15.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/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.v14.common.AdTextAsset;
-import com.google.ads.googleads.v14.common.CustomizerValue;
-import com.google.ads.googleads.v14.common.ResponsiveSearchAdInfo;
-import com.google.ads.googleads.v14.enums.CustomizerAttributeTypeEnum.CustomizerAttributeType;
-import com.google.ads.googleads.v14.enums.ServedAssetFieldTypeEnum.ServedAssetFieldType;
-import com.google.ads.googleads.v14.errors.GoogleAdsError;
-import com.google.ads.googleads.v14.errors.GoogleAdsException;
-import com.google.ads.googleads.v14.resources.Ad;
-import com.google.ads.googleads.v14.resources.AdGroupAd;
-import com.google.ads.googleads.v14.resources.AdGroupCustomizer;
-import com.google.ads.googleads.v14.resources.CustomizerAttribute;
-import com.google.ads.googleads.v14.services.AdGroupAdOperation;
-import com.google.ads.googleads.v14.services.AdGroupAdServiceClient;
-import com.google.ads.googleads.v14.services.AdGroupCustomizerOperation;
-import com.google.ads.googleads.v14.services.AdGroupCustomizerServiceClient;
-import com.google.ads.googleads.v14.services.CustomizerAttributeOperation;
-import com.google.ads.googleads.v14.services.CustomizerAttributeServiceClient;
-import com.google.ads.googleads.v14.services.MutateAdGroupAdResult;
-import com.google.ads.googleads.v14.services.MutateAdGroupAdsResponse;
-import com.google.ads.googleads.v14.services.MutateAdGroupCustomizerResult;
-import com.google.ads.googleads.v14.services.MutateAdGroupCustomizersResponse;
-import com.google.ads.googleads.v14.services.MutateCustomizerAttributesResponse;
-import com.google.ads.googleads.v14.utils.ResourceNames;
+import com.google.ads.googleads.v15.common.AdTextAsset;
+import com.google.ads.googleads.v15.common.CustomizerValue;
+import com.google.ads.googleads.v15.common.ResponsiveSearchAdInfo;
+import com.google.ads.googleads.v15.enums.CustomizerAttributeTypeEnum.CustomizerAttributeType;
+import com.google.ads.googleads.v15.enums.ServedAssetFieldTypeEnum.ServedAssetFieldType;
+import com.google.ads.googleads.v15.errors.GoogleAdsError;
+import com.google.ads.googleads.v15.errors.GoogleAdsException;
+import com.google.ads.googleads.v15.resources.Ad;
+import com.google.ads.googleads.v15.resources.AdGroupAd;
+import com.google.ads.googleads.v15.resources.AdGroupCustomizer;
+import com.google.ads.googleads.v15.resources.CustomizerAttribute;
+import com.google.ads.googleads.v15.services.AdGroupAdOperation;
+import com.google.ads.googleads.v15.services.AdGroupAdServiceClient;
+import com.google.ads.googleads.v15.services.AdGroupCustomizerOperation;
+import com.google.ads.googleads.v15.services.AdGroupCustomizerServiceClient;
+import com.google.ads.googleads.v15.services.CustomizerAttributeOperation;
+import com.google.ads.googleads.v15.services.CustomizerAttributeServiceClient;
+import com.google.ads.googleads.v15.services.MutateAdGroupAdResult;
+import com.google.ads.googleads.v15.services.MutateAdGroupAdsResponse;
+import com.google.ads.googleads.v15.services.MutateAdGroupCustomizerResult;
+import com.google.ads.googleads.v15.services.MutateAdGroupCustomizersResponse;
+import com.google.ads.googleads.v15.services.MutateCustomizerAttributesResponse;
+import com.google.ads.googleads.v15.utils.ResourceNames;
 import com.google.common.collect.ImmutableList;
 import java.io.FileNotFoundException;
 import java.io.IOException;

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

@@ -18,16 +18,16 @@
 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.v14.common.DeviceInfo;
-import com.google.ads.googleads.v14.enums.DeviceEnum.Device;
-import com.google.ads.googleads.v14.errors.GoogleAdsError;
-import com.google.ads.googleads.v14.errors.GoogleAdsException;
-import com.google.ads.googleads.v14.resources.AdGroupBidModifier;
-import com.google.ads.googleads.v14.services.AdGroupBidModifierOperation;
-import com.google.ads.googleads.v14.services.AdGroupBidModifierServiceClient;
-import com.google.ads.googleads.v14.services.MutateAdGroupBidModifierResult;
-import com.google.ads.googleads.v14.services.MutateAdGroupBidModifiersResponse;
-import com.google.ads.googleads.v14.utils.ResourceNames;
+import com.google.ads.googleads.v15.common.DeviceInfo;
+import com.google.ads.googleads.v15.enums.DeviceEnum.Device;
+import com.google.ads.googleads.v15.errors.GoogleAdsError;
+import com.google.ads.googleads.v15.errors.GoogleAdsException;
+import com.google.ads.googleads.v15.resources.AdGroupBidModifier;
+import com.google.ads.googleads.v15.services.AdGroupBidModifierOperation;
+import com.google.ads.googleads.v15.services.AdGroupBidModifierServiceClient;
+import com.google.ads.googleads.v15.services.MutateAdGroupBidModifierResult;
+import com.google.ads.googleads.v15.services.MutateAdGroupBidModifiersResponse;
+import com.google.ads.googleads.v15.utils.ResourceNames;
 import com.google.common.collect.ImmutableList;
 import java.io.FileNotFoundException;
 import java.io.IOException;