google-ads-api 25.1.0 → 25.1.1-beta.0

package/README.md

@@ -68,12 +68,12 @@ import { GoogleAdsApi } from "google-ads-api";
 const client = new GoogleAdsApi({
   client_id: "<CLIENT-ID>",
   client_secret: "<CLIENT-SECRET>",
-  developer_token: "<DEVELOPER-TOKEN>",
 });
 ```
 
 Optional client settings:
 
+- `developer_token`: no longer needed. Google sunset developer tokens on 9 September 2026; API access levels now belong to the Google Cloud project that owns your OAuth client, and the API ignores the token. When it is unset or empty, no `developer-token` header is sent. Existing configurations that pass a token keep working until Google starts rejecting the header in a future major API version.
 - `grpc_channel_options`: [gRPC channel options](https://github.com/grpc/grpc-node/tree/master/packages/grpc-js#supported-channel-options) applied to every service client this instance creates, for example `{ "grpc.keepalive_time_ms": 30000, "grpc.keepalive_timeout_ms": 10000 }`. Cached service clients are keyed by client id, refresh token and these options, so instances with different options never share a client.
 - `max_reporting_rows`: throw once a report or query returns more rows than this.
 - `disable_parsing`: return raw API responses instead of parsed rows.
@@ -107,7 +107,6 @@ This is a special client method for listing the accessible customers for a given
 const client = new GoogleAdsApi({
   client_id: "<CLIENT-ID>",
   client_secret: "<CLIENT-SECRET>",
-  developer_token: "<DEVELOPER-TOKEN>",
 });
 
 const refreshToken = "<REFRESH-TOKEN>";

package/build/cjs/client.d.ts

@@ -6,7 +6,13 @@ import { services } from "./protos/index.js";
 export interface ClientOptions {
     client_id: string;
     client_secret: string;
-    developer_token: string;
+    /**
+     * Optional since the Google Ads API moved access levels from developer
+     * tokens to Google Cloud projects (September 2026). When unset or empty,
+     * no `developer-token` header is sent. The API ignores the value when it is
+     * present and will reject the header in a future major version.
+     */
+    developer_token?: string;
     disable_parsing?: boolean;
     max_reporting_rows?: number;
     grpc_channel_options?: grpc.ChannelOptions;

package/build/cjs/service.d.ts

@@ -5,7 +5,7 @@ import { Hooks } from "./hooks.js";
 import TTLCache from "@isaacs/ttlcache";
 export declare const FAILURE_KEY = "google.ads.googleads.v25.errors.googleadsfailure-bin";
 export interface CallHeaders {
-    "developer-token": string;
+    "developer-token"?: string;
     "login-customer-id"?: string;
     "linked-customer-id"?: string;
 }

package/build/cjs/service.js

@@ -84,9 +84,12 @@ class Service {
         };
     }
     get callHeaders() {
-        const headers = {
-            "developer-token": this.clientOptions.developer_token,
-        };
+        const headers = {};
+        // Omitted rather than sent empty: the API rejects an empty developer-token
+        // header (DEVELOPER_TOKEN_PARAMETER_MISSING) but accepts a missing one.
+        if (this.clientOptions.developer_token) {
+            headers["developer-token"] = this.clientOptions.developer_token;
+        }
         if (this.customerOptions.login_customer_id) {
             headers["login-customer-id"] = this.customerOptions.login_customer_id;
         }

package/build/esm/client.d.ts

@@ -6,7 +6,13 @@ import { services } from "./protos/index.js";
 export interface ClientOptions {
     client_id: string;
     client_secret: string;
-    developer_token: string;
+    /**
+     * Optional since the Google Ads API moved access levels from developer
+     * tokens to Google Cloud projects (September 2026). When unset or empty,
+     * no `developer-token` header is sent. The API ignores the value when it is
+     * present and will reject the header in a future major version.
+     */
+    developer_token?: string;
     disable_parsing?: boolean;
     max_reporting_rows?: number;
     grpc_channel_options?: grpc.ChannelOptions;

package/build/esm/service.d.ts

@@ -5,7 +5,7 @@ import { Hooks } from "./hooks.js";
 import TTLCache from "@isaacs/ttlcache";
 export declare const FAILURE_KEY = "google.ads.googleads.v25.errors.googleadsfailure-bin";
 export interface CallHeaders {
-    "developer-token": string;
+    "developer-token"?: string;
     "login-customer-id"?: string;
     "linked-customer-id"?: string;
 }

package/build/esm/service.js

@@ -44,9 +44,12 @@ export class Service {
         };
     }
     get callHeaders() {
-        const headers = {
-            "developer-token": this.clientOptions.developer_token,
-        };
+        const headers = {};
+        // Omitted rather than sent empty: the API rejects an empty developer-token
+        // header (DEVELOPER_TOKEN_PARAMETER_MISSING) but accepts a missing one.
+        if (this.clientOptions.developer_token) {
+            headers["developer-token"] = this.clientOptions.developer_token;
+        }
         if (this.customerOptions.login_customer_id) {
             headers["login-customer-id"] = this.customerOptions.login_customer_id;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "google-ads-api",
-  "version": "25.1.0",
+  "version": "25.1.1-beta.0",
   "description": "Google Ads API Client Library for Node.js",
   "repository": {
     "type": "git",