Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
1 change: 1 addition & 0 deletions Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -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
2 changes: 1 addition & 1 deletion Makefile
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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">
Expand Down
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -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": [
Expand Down
2 changes: 2 additions & 0 deletions package/googleads-nodejs/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down Expand Up @@ -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",
Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand All @@ -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.

Expand All @@ -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.
Expand Down Expand Up @@ -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.
Expand All @@ -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.
Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand All @@ -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.

Expand Down Expand Up @@ -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.
Expand Down Expand Up @@ -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;
}

Expand Down Expand Up @@ -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;
Expand Down Expand Up @@ -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'.
Expand Down Expand Up @@ -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.
Expand Down Expand Up @@ -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.
Expand Down Expand Up @@ -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.
Expand Down Expand Up @@ -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,
Expand Down Expand Up @@ -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.
Expand Down Expand Up @@ -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;

Expand Down
Original file line number Diff line number Diff line change
@@ -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.
Expand All @@ -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.

Expand All @@ -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;
}
Loading
Loading