Merge pull request #133 from Opteo/google-ads-v23

Google Ads v23

Author: Lewis-Clayton

Dockerfile

@@ -62,4 +62,5 @@ RUN sed -i 's/request.keywordPlan/request.keyword_plan/' googleads-nodejs/src/${
     sed -i 's/request.resourceName/request.resource_name/' googleads-nodejs/src/${GOOGLE_ADS_VERSION}/*.ts && \
     sed -i 's/request.customerId/request.customer_id/' googleads-nodejs/src/${GOOGLE_ADS_VERSION}/*.ts && \
     sed -i 's/request.adGroupAd/request.ad_group_ad/' googleads-nodejs/src/${GOOGLE_ADS_VERSION}/*.ts && \
+    sed -i 's/request.selectedIncentiveId/request.selected_incentive_id/' googleads-nodejs/src/${GOOGLE_ADS_VERSION}/*.ts && \
     sed -i 's/"compile-protos": "compileProtos src"/"compile-protos": "compileProtos --keep-case --force-number src"/' googleads-nodejs/package.json

Makefile

@@ -1,6 +1,6 @@
 # Google Ads API version
 # This only needs changing for major versions e.g. v8 -> v9
-GOOGLE_ADS_VERSION=v22
+GOOGLE_ADS_VERSION=v23
 
 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-v22-009688.svg?style=flat-square">
+    <img src="https://img.shields.io/badge/google%20ads-v23-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-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "google-ads-node",
-  "version": "19.0.0",
+  "version": "23.0.0-beta.0",
   "description": "Google Ads API client library",
   "main": "build/src/index.js",
   "files": [

package.json

@@ -48,6 +48,7 @@
     "audience service",
     "automatically created asset removal service",
     "batch job service",
+    "benchmarks service",
     "bidding data exclusion service",
     "bidding seasonality adjustment service",
     "bidding strategy service",
@@ -100,6 +101,7 @@
     "google ads field service",
     "google ads service",
     "identity verification service",
+    "incentive service",
     "invoice service",
     "keyword plan ad group keyword service",
     "keyword plan ad group service",

package/googleads-nodejs/package.json

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -14,20 +14,20 @@
 
 syntax = "proto3";
 
-package google.ads.googleads.v22.common;
+package google.ads.googleads.v23.common;
 
-import "google/ads/googleads/v22/common/asset_policy.proto";
-import "google/ads/googleads/v22/enums/asset_performance_label.proto";
-import "google/ads/googleads/v22/enums/served_asset_field_type.proto";
+import "google/ads/googleads/v23/common/asset_policy.proto";
+import "google/ads/googleads/v23/enums/asset_performance_label.proto";
+import "google/ads/googleads/v23/enums/served_asset_field_type.proto";
 
-option csharp_namespace = "Google.Ads.GoogleAds.V22.Common";
-option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v22/common;common";
+option csharp_namespace = "Google.Ads.GoogleAds.V23.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v23/common;common";
 option java_multiple_files = true;
 option java_outer_classname = "AdAssetProto";
-option java_package = "com.google.ads.googleads.v22.common";
+option java_package = "com.google.ads.googleads.v23.common";
 option objc_class_prefix = "GAA";
-option php_namespace = "Google\\Ads\\GoogleAds\\V22\\Common";
-option ruby_package = "Google::Ads::GoogleAds::V22::Common";
+option php_namespace = "Google\\Ads\\GoogleAds\\V23\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V23::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.v22.enums.ServedAssetFieldTypeEnum.ServedAssetFieldType
+  google.ads.googleads.v23.enums.ServedAssetFieldTypeEnum.ServedAssetFieldType
       pinned_field = 2;
 
   // The performance label of this text asset.
-  google.ads.googleads.v22.enums.AssetPerformanceLabelEnum.AssetPerformanceLabel
+  google.ads.googleads.v23.enums.AssetPerformanceLabelEnum.AssetPerformanceLabel
       asset_performance_label = 5;
 
   // The policy summary of this text asset.
@@ -78,6 +78,11 @@ message AdVideoAssetInfo {
   // given ad slot can be found.
   optional AdVideoAssetInventoryPreferences
       ad_video_asset_inventory_preferences = 1;
+
+  // Defines feature controls for this AdVideoAsset during serving time.
+  // For example, whether YouTube comments should be enabled for Partnership Ads
+  // served on YouTube Shorts.
+  optional AdVideoAssetLinkFeatureControl ad_video_asset_feature_control = 2;
 }
 
 // YouTube Video Asset inventory preferences.
@@ -95,6 +100,13 @@ message AdVideoAssetInventoryPreferences {
   optional bool shorts_preference = 3;
 }
 
+// YouTube Video Asset feature controls.
+message AdVideoAssetLinkFeatureControl {
+  // Defines if YouTube comments should be enabled for the creative
+  // using this YouTube video asset served on YouTube Shorts.
+  optional bool allow_youtube_comments = 1;
+}
+
 // A media bundle asset used inside an ad.
 message AdMediaBundleAsset {
   // The Asset resource name of this media bundle.

…/ads/googleads/v22/common/ad_asset.proto …/ads/googleads/v23/common/ad_asset.protopackage/googleads-nodejs/protos/google/ads/googleads/v22/common/ad_asset.proto renamed to package/googleads-nodejs/protos/google/ads/googleads/v23/common/ad_asset.proto package/googleads-nodejs/protos/google/ads/googleads/v22/common/ad_asset.proto renamed to package/googleads-nodejs/protos/google/ads/googleads/v23/common/ad_asset.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -14,25 +14,24 @@
 
 syntax = "proto3";
 
-package google.ads.googleads.v22.common;
+package google.ads.googleads.v23.common;
 
-import "google/ads/googleads/v22/common/ad_asset.proto";
-import "google/ads/googleads/v22/enums/call_conversion_reporting_state.proto";
-import "google/ads/googleads/v22/enums/display_ad_format_setting.proto";
-import "google/ads/googleads/v22/enums/display_upload_product_type.proto";
-import "google/ads/googleads/v22/enums/legacy_app_install_ad_app_store.proto";
-import "google/ads/googleads/v22/enums/mime_type.proto";
-import "google/ads/googleads/v22/enums/video_thumbnail.proto";
+import "google/ads/googleads/v23/common/ad_asset.proto";
+import "google/ads/googleads/v23/enums/display_ad_format_setting.proto";
+import "google/ads/googleads/v23/enums/display_upload_product_type.proto";
+import "google/ads/googleads/v23/enums/legacy_app_install_ad_app_store.proto";
+import "google/ads/googleads/v23/enums/mime_type.proto";
+import "google/ads/googleads/v23/enums/video_thumbnail.proto";
 import "google/api/field_behavior.proto";
 
-option csharp_namespace = "Google.Ads.GoogleAds.V22.Common";
-option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v22/common;common";
+option csharp_namespace = "Google.Ads.GoogleAds.V23.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v23/common;common";
 option java_multiple_files = true;
 option java_outer_classname = "AdTypeInfosProto";
-option java_package = "com.google.ads.googleads.v22.common";
+option java_package = "com.google.ads.googleads.v23.common";
 option objc_class_prefix = "GAA";
-option php_namespace = "Google\\Ads\\GoogleAds\\V22\\Common";
-option ruby_package = "Google::Ads::GoogleAds::V22::Common";
+option php_namespace = "Google\\Ads\\GoogleAds\\V23\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V23::Common";
 
 // Proto file containing info messages for specific ad types.
 
@@ -121,7 +120,7 @@ message ImageAdInfo {
   optional string preview_image_url = 20;
 
   // The mime type of the image.
-  google.ads.googleads.v22.enums.MimeTypeEnum.MimeType mime_type = 10;
+  google.ads.googleads.v23.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 +211,7 @@ message InFeedVideoAdInfo {
   string description2 = 3;
 
   // Video thumbnail image to use.
-  google.ads.googleads.v22.enums.VideoThumbnailEnum.VideoThumbnail thumbnail =
+  google.ads.googleads.v23.enums.VideoThumbnailEnum.VideoThumbnail thumbnail =
       4;
 }
 
@@ -268,6 +267,13 @@ message VideoResponsiveAdInfo {
   // Currently, only a single value for the YouTube video asset is supported.
   repeated AdVideoAsset videos = 5;
 
+  // Optional advertiser/brand name. Maximum display width is 25 characters.
+  AdTextAsset business_name = 9;
+
+  // Optional logo image to be used in the ad. The minimum size is 128x128 and
+  // the aspect ratio must be 1:1(+-1%).
+  repeated AdImageAsset logo_images = 10;
+
   // List of image assets used for the companion banner.
   // Currently, only a single value for the companion banner asset is supported.
   repeated AdImageAsset companion_banners = 6;
@@ -355,7 +361,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.v22.enums.DisplayAdFormatSettingEnum
+  google.ads.googleads.v23.enums.DisplayAdFormatSettingEnum
       .DisplayAdFormatSetting format_setting = 13;
 
   // Prefix before price. For example, 'as low as'.
@@ -439,7 +445,7 @@ message LegacyAppInstallAdInfo {
   optional string app_id = 6;
 
   // The app store the mobile app is available in.
-  google.ads.googleads.v22.enums.LegacyAppInstallAdAppStoreEnum
+  google.ads.googleads.v23.enums.LegacyAppInstallAdAppStoreEnum
       .LegacyAppInstallAdAppStore app_store = 2;
 
   // The headline of the ad.
@@ -521,7 +527,7 @@ message ResponsiveDisplayAdInfo {
   optional string promo_text = 23;
 
   // Specifies which format the ad will be served in. Default is ALL_FORMATS.
-  google.ads.googleads.v22.enums.DisplayAdFormatSettingEnum
+  google.ads.googleads.v23.enums.DisplayAdFormatSettingEnum
       .DisplayAdFormatSetting format_setting = 16;
 
   // Specification for various creative controls.
@@ -572,7 +578,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.v22.enums.DisplayUploadProductTypeEnum
+  google.ads.googleads.v23.enums.DisplayUploadProductTypeEnum
       .DisplayUploadProductType display_upload_product_type = 1;
 
   // The asset data that makes up the ad.
@@ -608,60 +614,6 @@ message SmartCampaignAdInfo {
   repeated AdTextAsset descriptions = 2;
 }
 
-// A call ad.
-message CallAdInfo {
-  // The country code in the ad.
-  string country_code = 1;
-
-  // The phone number in the ad.
-  string phone_number = 2;
-
-  // The business name in the ad.
-  string business_name = 3;
-
-  // First headline in the ad.
-  string headline1 = 11;
-
-  // Second headline in the ad.
-  string headline2 = 12;
-
-  // The first line of the ad's description.
-  string description1 = 4;
-
-  // The second line of the ad's description.
-  string description2 = 5;
-
-  // Whether to enable call tracking for the creative. Enabling call
-  // tracking also enables call conversions.
-  bool call_tracked = 6;
-
-  // Whether to disable call conversion for the creative.
-  // If set to `true`, disables call conversions even when `call_tracked` is
-  // `true`.
-  // If `call_tracked` is `false`, this field is ignored.
-  bool disable_call_conversion = 7;
-
-  // The URL to be used for phone number verification.
-  string phone_number_verification_url = 8;
-
-  // The conversion action to attribute a call conversion to. If not set a
-  // default conversion action is used. This field only has effect if
-  // `call_tracked` is set to `true`. Otherwise this field is ignored.
-  string conversion_action = 9;
-
-  // 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.v22.enums.CallConversionReportingStateEnum
-      .CallConversionReportingState conversion_reporting_state = 10;
-
-  // First part of text that can be appended to the URL in the ad. Optional.
-  string path1 = 13;
-
-  // Second part of text that can be appended to the URL in the ad. This field
-  // can only be set when `path1` is also set. Optional.
-  string path2 = 14;
-}
-
 // A Demand Gen multi asset ad.
 message DemandGenMultiAssetAdInfo {
   // Marketing image assets to be used in the ad. Valid image types are GIF,
@@ -711,9 +663,6 @@ message DemandGenMultiAssetAdInfo {
 
   // Call to action text.
   optional string call_to_action_text = 8;
-
-  // Boolean option that indicates if this ad must be served with lead form.
-  optional bool lead_form_only = 9;
 }
 
 // A Demand Gen carousel ad.
@@ -757,6 +706,10 @@ message DemandGenVideoResponsiveAdInfo {
   // The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%).
   repeated AdImageAsset logo_images = 5;
 
+  // List of image assets used for the companion banner.
+  // Currently, only a single value for the companion banner asset is supported.
+  repeated AdImageAsset companion_banners = 10;
+
   // First part of text that appears in the ad with the displayed URL.
   string breadcrumb1 = 6;
 

…googleads/v22/common/ad_type_infos.proto …googleads/v23/common/ad_type_infos.protopackage/googleads-nodejs/protos/google/ads/googleads/v22/common/ad_type_infos.proto renamed to package/googleads-nodejs/protos/google/ads/googleads/v23/common/ad_type_infos.proto package/googleads-nodejs/protos/google/ads/googleads/v22/common/ad_type_infos.proto renamed to package/googleads-nodejs/protos/google/ads/googleads/v23/common/ad_type_infos.proto

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -14,18 +14,18 @@
 
 syntax = "proto3";
 
-package google.ads.googleads.v22.common;
+package google.ads.googleads.v23.common;
 
-import "google/ads/googleads/v22/enums/application_instance.proto";
+import "google/ads/googleads/v23/enums/application_instance.proto";
 
-option csharp_namespace = "Google.Ads.GoogleAds.V22.Common";
-option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v22/common;common";
+option csharp_namespace = "Google.Ads.GoogleAds.V23.Common";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v23/common;common";
 option java_multiple_files = true;
 option java_outer_classname = "AdditionalApplicationInfoProto";
-option java_package = "com.google.ads.googleads.v22.common";
+option java_package = "com.google.ads.googleads.v23.common";
 option objc_class_prefix = "GAA";
-option php_namespace = "Google\\Ads\\GoogleAds\\V22\\Common";
-option ruby_package = "Google::Ads::GoogleAds::V22::Common";
+option php_namespace = "Google\\Ads\\GoogleAds\\V23\\Common";
+option ruby_package = "Google::Ads::GoogleAds::V23::Common";
 
 // Proto file describing common application info proto messages.
 
@@ -39,6 +39,6 @@ message AdditionalApplicationInfo {
   string application_id = 1;
 
   // The instance type of the application sending the request.
-  google.ads.googleads.v22.enums.ApplicationInstanceEnum.ApplicationInstance
+  google.ads.googleads.v23.enums.ApplicationInstanceEnum.ApplicationInstance
       application_instance = 2;
 }