V20.0

Makefile

@@ -1,6 +1,6 @@
 # Google Ads API version
 # This only needs changing for major versions e.g. v8 -> v9
-GOOGLE_ADS_VERSION=v19
+GOOGLE_ADS_VERSION=v20
 
 BUNDLE=googleads-nodejs.tar.gz
 PACKAGE_BUILD=/package/googleads-nodejs

README.md

@@ -10,7 +10,7 @@
 
 <p align="center">
   <a href="https://developers.google.com/google-ads/api/docs/release-notes">
-    <img src="https://img.shields.io/badge/google%20ads-v17-009688.svg?style=flat-square">
+    <img src="https://img.shields.io/badge/google%20ads-v20-009688.svg?style=flat-square">
   </a>
   <a href="https://www.npmjs.com/package/google-ads-node">
     <img src="https://img.shields.io/npm/v/google-ads-node.svg?style=flat-square">

package.json

@@ -1,6 +1,6 @@
 {
   "name": "google-ads-node",
-  "version": "16.0.0",
+  "version": "17.0.0",
   "description": "Google Ads API client library",
   "main": "build/src/index.js",
   "files": [
@@ -15,7 +15,7 @@
     "prepare": "sh ./init.sh"
   },
   "dependencies": {
-    "google-gax": "5.1.0-rc.1",
+    "google-gax": "^5.1.1-rc.1",
     "lru-cache": "^10.2.0"
   },
   "devDependencies": {

package/googleads-nodejs/package.json

@@ -141,7 +141,7 @@
     "@types/node": "^22.14.1",
     "@types/sinon": "^17.0.4",
     "c8": "^10.1.3",
-    "gapic-tools": "^1.0.1",
+    "gapic-tools": "^1.0.2",
     "gts": "^6.0.2",
     "jsdoc": "^4.0.4",
     "jsdoc-fresh": "^3.0.0",
@@ -155,6 +155,6 @@
     "node": ">=v18"
   },
   "dependencies": {
-    "google-gax": "^5.1.0-rc.1"
+    "google-gax": "^5.1.1-rc.1"
   }
 }

package/googleads-nodejs/protos/google/ads/googleads/v19/common/ad_asset.proto → package/googleads-nodejs/protos/google/ads/googleads/v20/common/ad_asset.proto

@@ -14,20 +14,20 @@
 
 syntax = "proto3";
 
-package google.ads.googleads.v19.common;
+package google.ads.googleads.v20.common;
 
-import "google/ads/googleads/v19/common/asset_policy.proto";
-import "google/ads/googleads/v19/enums/asset_performance_label.proto";
-import "google/ads/googleads/v19/enums/served_asset_field_type.proto";
+import "google/ads/googleads/v20/common/asset_policy.proto";
+import "google/ads/googleads/v20/enums/asset_performance_label.proto";
+import "google/ads/googleads/v20/enums/served_asset_field_type.proto";
 
-option csharp_namespace = "Google.Ads.GoogleAds.V19.Common";
-option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v19/common;common";
+option csharp_namespace = "Google.Ads.GoogleAds.V20.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v20/common;common";
 option java_multiple_files = true;
 option java_outer_classname = "AdAssetProto";
-option java_package = "com.google.ads.googleads.v19.common";
+option java_package = "com.google.ads.googleads.v20.common";
 option objc_class_prefix = "GAA";
-option php_namespace = "Google\\Ads\\GoogleAds\\V19\\Common";
-option ruby_package = "Google::Ads::GoogleAds::V19::Common";
+option php_namespace = "Google\\Ads\\GoogleAds\\V20\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V20::Common";
 
 // Proto file describing assets used inside an ad.
 
@@ -40,11 +40,11 @@ message AdTextAsset {
   // within this field. Multiple assets can be pinned to the same field. An
   // asset that is unpinned or pinned to a different field will not serve in a
   // field where some other asset has been pinned.
-  google.ads.googleads.v19.enums.ServedAssetFieldTypeEnum.ServedAssetFieldType
+  google.ads.googleads.v20.enums.ServedAssetFieldTypeEnum.ServedAssetFieldType
       pinned_field = 2;
 
   // The performance label of this text asset.
-  google.ads.googleads.v19.enums.AssetPerformanceLabelEnum.AssetPerformanceLabel
+  google.ads.googleads.v20.enums.AssetPerformanceLabelEnum.AssetPerformanceLabel
       asset_performance_label = 5;
 
   // The policy summary of this text asset.

package/googleads-nodejs/protos/google/ads/googleads/v19/common/ad_type_infos.proto → package/googleads-nodejs/protos/google/ads/googleads/v20/common/ad_type_infos.proto

@@ -14,25 +14,25 @@
 
 syntax = "proto3";
 
-package google.ads.googleads.v19.common;
-
-import "google/ads/googleads/v19/common/ad_asset.proto";
-import "google/ads/googleads/v19/enums/call_conversion_reporting_state.proto";
-import "google/ads/googleads/v19/enums/display_ad_format_setting.proto";
-import "google/ads/googleads/v19/enums/display_upload_product_type.proto";
-import "google/ads/googleads/v19/enums/legacy_app_install_ad_app_store.proto";
-import "google/ads/googleads/v19/enums/mime_type.proto";
-import "google/ads/googleads/v19/enums/video_thumbnail.proto";
+package google.ads.googleads.v20.common;
+
+import "google/ads/googleads/v20/common/ad_asset.proto";
+import "google/ads/googleads/v20/enums/call_conversion_reporting_state.proto";
+import "google/ads/googleads/v20/enums/display_ad_format_setting.proto";
+import "google/ads/googleads/v20/enums/display_upload_product_type.proto";
+import "google/ads/googleads/v20/enums/legacy_app_install_ad_app_store.proto";
+import "google/ads/googleads/v20/enums/mime_type.proto";
+import "google/ads/googleads/v20/enums/video_thumbnail.proto";
 import "google/api/field_behavior.proto";
 
-option csharp_namespace = "Google.Ads.GoogleAds.V19.Common";
-option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v19/common;common";
+option csharp_namespace = "Google.Ads.GoogleAds.V20.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v20/common;common";
 option java_multiple_files = true;
 option java_outer_classname = "AdTypeInfosProto";
-option java_package = "com.google.ads.googleads.v19.common";
+option java_package = "com.google.ads.googleads.v20.common";
 option objc_class_prefix = "GAA";
-option php_namespace = "Google\\Ads\\GoogleAds\\V19\\Common";
-option ruby_package = "Google::Ads::GoogleAds::V19::Common";
+option php_namespace = "Google\\Ads\\GoogleAds\\V20\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V20::Common";
 
 // Proto file containing info messages for specific ad types.
 
@@ -121,7 +121,7 @@ message ImageAdInfo {
   optional string preview_image_url = 20;
 
   // The mime type of the image.
-  google.ads.googleads.v19.enums.MimeTypeEnum.MimeType mime_type = 10;
+  google.ads.googleads.v20.enums.MimeTypeEnum.MimeType mime_type = 10;
 
   // The name of the image. If the image was created from a MediaFile, this is
   // the MediaFile's name. If the image was created from bytes, this is empty.
@@ -212,7 +212,7 @@ message InFeedVideoAdInfo {
   string description2 = 3;
 
   // Video thumbnail image to use.
-  google.ads.googleads.v19.enums.VideoThumbnailEnum.VideoThumbnail thumbnail =
+  google.ads.googleads.v20.enums.VideoThumbnailEnum.VideoThumbnail thumbnail =
       4;
 }
 
@@ -355,7 +355,7 @@ message LegacyResponsiveDisplayAdInfo {
   optional string square_marketing_image = 27;
 
   // Specifies which format the ad will be served in. Default is ALL_FORMATS.
-  google.ads.googleads.v19.enums.DisplayAdFormatSettingEnum
+  google.ads.googleads.v20.enums.DisplayAdFormatSettingEnum
       .DisplayAdFormatSetting format_setting = 13;
 
   // Prefix before price. For example, 'as low as'.
@@ -439,7 +439,7 @@ message LegacyAppInstallAdInfo {
   optional string app_id = 6;
 
   // The app store the mobile app is available in.
-  google.ads.googleads.v19.enums.LegacyAppInstallAdAppStoreEnum
+  google.ads.googleads.v20.enums.LegacyAppInstallAdAppStoreEnum
       .LegacyAppInstallAdAppStore app_store = 2;
 
   // The headline of the ad.
@@ -521,7 +521,7 @@ message ResponsiveDisplayAdInfo {
   optional string promo_text = 23;
 
   // Specifies which format the ad will be served in. Default is ALL_FORMATS.
-  google.ads.googleads.v19.enums.DisplayAdFormatSettingEnum
+  google.ads.googleads.v20.enums.DisplayAdFormatSettingEnum
       .DisplayAdFormatSetting format_setting = 16;
 
   // Specification for various creative controls.
@@ -572,7 +572,7 @@ message LocalAdInfo {
 // need to be included with the ad.
 message DisplayUploadAdInfo {
   // The product type of this ad. See comments on the enum for details.
-  google.ads.googleads.v19.enums.DisplayUploadProductTypeEnum
+  google.ads.googleads.v20.enums.DisplayUploadProductTypeEnum
       .DisplayUploadProductType display_upload_product_type = 1;
 
   // The asset data that makes up the ad.
@@ -651,7 +651,7 @@ message CallAdInfo {
 
   // The call conversion behavior of this call ad. It can use its own call
   // conversion setting, inherit the account level setting, or be disabled.
-  google.ads.googleads.v19.enums.CallConversionReportingStateEnum
+  google.ads.googleads.v20.enums.CallConversionReportingStateEnum
       .CallConversionReportingState conversion_reporting_state = 10;
 
   // First part of text that can be appended to the URL in the ad. Optional.

package/googleads-nodejs/protos/google/ads/googleads/v20/common/additional_application_info.proto

@@ -0,0 +1,44 @@
+// Copyright 2025 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.ads.googleads.v20.common;
+
+import "google/ads/googleads/v20/enums/application_instance.proto";
+
+option csharp_namespace = "Google.Ads.GoogleAds.V20.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v20/common;common";
+option java_multiple_files = true;
+option java_outer_classname = "AdditionalApplicationInfoProto";
+option java_package = "com.google.ads.googleads.v20.common";
+option objc_class_prefix = "GAA";
+option php_namespace = "Google\\Ads\\GoogleAds\\V20\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V20::Common";
+
+// Proto file describing common application info proto messages.
+
+// Additional information about the application/tool issuing the request. This
+// field is only used by [ContentCreatorInsightsService],
+// [AudienceInsightsService], and [ReachPlanService] APIs.
+message AdditionalApplicationInfo {
+  // The unique identifier of the agency proprietary application. This
+  // identifier is generated by Google. Reach out to your Google representative
+  // to request an application_id for each new application being integrated.
+  string application_id = 1;
+
+  // The instance type of the application sending the request.
+  google.ads.googleads.v20.enums.ApplicationInstanceEnum.ApplicationInstance
+      application_instance = 2;
+}

package/googleads-nodejs/protos/google/ads/googleads/v19/common/asset_policy.proto → package/googleads-nodejs/protos/google/ads/googleads/v20/common/asset_policy.proto

@@ -14,23 +14,23 @@
 
 syntax = "proto3";
 
-package google.ads.googleads.v19.common;
+package google.ads.googleads.v20.common;
 
-import "google/ads/googleads/v19/common/policy.proto";
-import "google/ads/googleads/v19/enums/asset_link_primary_status.proto";
-import "google/ads/googleads/v19/enums/asset_link_primary_status_reason.proto";
-import "google/ads/googleads/v19/enums/asset_offline_evaluation_error_reasons.proto";
-import "google/ads/googleads/v19/enums/policy_approval_status.proto";
-import "google/ads/googleads/v19/enums/policy_review_status.proto";
+import "google/ads/googleads/v20/common/policy.proto";
+import "google/ads/googleads/v20/enums/asset_link_primary_status.proto";
+import "google/ads/googleads/v20/enums/asset_link_primary_status_reason.proto";
+import "google/ads/googleads/v20/enums/asset_offline_evaluation_error_reasons.proto";
+import "google/ads/googleads/v20/enums/policy_approval_status.proto";
+import "google/ads/googleads/v20/enums/policy_review_status.proto";
 
-option csharp_namespace = "Google.Ads.GoogleAds.V19.Common";
-option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v19/common;common";
+option csharp_namespace = "Google.Ads.GoogleAds.V20.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v20/common;common";
 option java_multiple_files = true;
 option java_outer_classname = "AssetPolicyProto";
-option java_package = "com.google.ads.googleads.v19.common";
+option java_package = "com.google.ads.googleads.v20.common";
 option objc_class_prefix = "GAA";
-option php_namespace = "Google\\Ads\\GoogleAds\\V19\\Common";
-option ruby_package = "Google::Ads::GoogleAds::V19::Common";
+option php_namespace = "Google\\Ads\\GoogleAds\\V20\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V20::Common";
 
 // Proto file describing asset policies.
 
@@ -40,12 +40,12 @@ message AdAssetPolicySummary {
   repeated PolicyTopicEntry policy_topic_entries = 1;
 
   // Where in the review process this asset.
-  google.ads.googleads.v19.enums.PolicyReviewStatusEnum.PolicyReviewStatus
+  google.ads.googleads.v20.enums.PolicyReviewStatusEnum.PolicyReviewStatus
       review_status = 2;
 
   // The overall approval status of this asset, which is calculated based on
   // the status of its individual policy topic entries.
-  google.ads.googleads.v19.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus
+  google.ads.googleads.v20.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus
       approval_status = 3;
 }
 
@@ -58,11 +58,11 @@ message AdAssetPolicySummary {
 // evaluation errors which led to the asset being disapproved.
 message AssetLinkPrimaryStatusDetails {
   // Provides the reason of this PrimaryStatus.
-  optional google.ads.googleads.v19.enums.AssetLinkPrimaryStatusReasonEnum
+  optional google.ads.googleads.v20.enums.AssetLinkPrimaryStatusReasonEnum
       .AssetLinkPrimaryStatusReason reason = 1;
 
   // Provides the PrimaryStatus of this status detail.
-  optional google.ads.googleads.v19.enums.AssetLinkPrimaryStatusEnum
+  optional google.ads.googleads.v20.enums.AssetLinkPrimaryStatusEnum
       .AssetLinkPrimaryStatus status = 2;
 
   // Provides the details associated with the asset link primary status.
@@ -75,6 +75,6 @@ message AssetLinkPrimaryStatusDetails {
 // Details related to AssetLinkPrimaryStatusReasonPB.ASSET_DISAPPROVED
 message AssetDisapproved {
   // Provides the quality evaluation disapproval reason of an asset.
-  repeated google.ads.googleads.v19.enums.AssetOfflineEvaluationErrorReasonsEnum
+  repeated google.ads.googleads.v20.enums.AssetOfflineEvaluationErrorReasonsEnum
       .AssetOfflineEvaluationErrorReasons offline_evaluation_error_reasons = 1;
 }

package/googleads-nodejs/protos/google/ads/googleads/v19/common/asset_set_types.proto → package/googleads-nodejs/protos/google/ads/googleads/v20/common/asset_set_types.proto

@@ -14,21 +14,21 @@
 
 syntax = "proto3";
 
-package google.ads.googleads.v19.common;
+package google.ads.googleads.v20.common;
 
-import "google/ads/googleads/v19/enums/chain_relationship_type.proto";
-import "google/ads/googleads/v19/enums/location_ownership_type.proto";
-import "google/ads/googleads/v19/enums/location_string_filter_type.proto";
+import "google/ads/googleads/v20/enums/chain_relationship_type.proto";
+import "google/ads/googleads/v20/enums/location_ownership_type.proto";
+import "google/ads/googleads/v20/enums/location_string_filter_type.proto";
 import "google/api/field_behavior.proto";
 
-option csharp_namespace = "Google.Ads.GoogleAds.V19.Common";
-option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v19/common;common";
+option csharp_namespace = "Google.Ads.GoogleAds.V20.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v20/common;common";
 option java_multiple_files = true;
 option java_outer_classname = "AssetSetTypesProto";
-option java_package = "com.google.ads.googleads.v19.common";
+option java_package = "com.google.ads.googleads.v20.common";
 option objc_class_prefix = "GAA";
-option php_namespace = "Google\\Ads\\GoogleAds\\V19\\Common";
-option ruby_package = "Google::Ads::GoogleAds::V19::Common";
+option php_namespace = "Google\\Ads\\GoogleAds\\V20\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V20::Common";
 
 // Proto file containing info messages for specific asset set types.
 
@@ -38,7 +38,7 @@ option ruby_package = "Google::Ads::GoogleAds::V19::Common";
 message LocationSet {
   // Required. Immutable. Location Ownership Type (owned location or affiliate
   // location).
-  google.ads.googleads.v19.enums.LocationOwnershipTypeEnum.LocationOwnershipType
+  google.ads.googleads.v20.enums.LocationOwnershipTypeEnum.LocationOwnershipType
       location_ownership_type = 3 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.field_behavior) = IMMUTABLE
@@ -106,7 +106,7 @@ message BusinessProfileLocationSet {
 message ChainSet {
   // Required. Immutable. Relationship type the specified chains have with this
   // advertiser.
-  google.ads.googleads.v19.enums.ChainRelationshipTypeEnum.ChainRelationshipType
+  google.ads.googleads.v20.enums.ChainRelationshipTypeEnum.ChainRelationshipType
       relationship_type = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.field_behavior) = IMMUTABLE
@@ -173,7 +173,7 @@ message BusinessProfileBusinessNameFilter {
   string business_name = 1;
 
   // The type of string matching to use when filtering with business_name.
-  google.ads.googleads.v19.enums.LocationStringFilterTypeEnum
+  google.ads.googleads.v20.enums.LocationStringFilterTypeEnum
       .LocationStringFilterType filter_type = 2;
 }