google-ads-node (low-level Google Ads gRPC client)

Common errors

Warnings

Install

Imports

• GoogleAdsClient
  wrong

  const GoogleAdsClient = require('google-ads-node').GoogleAdsClient

  correct

  import { GoogleAdsClient } from 'google-ads-node'

  The package provides named exports; default export is not available. The require pattern works but is not the recommended ES module style.

• services
  wrong

  const { services } = require('google-ads-node')

  correct

  import { services } from 'google-ads-node'

  The services object contains all gRPC service stubs like CampaignService, AdGroupService, etc. Both import and require work.

• types

  import { types } from 'google-ads-node'

  The types object provides protobuf message types used in requests/responses. This is a named export.

• enums
  wrong

  const { enums } = require('google-ads-node').enums

  correct

  import { enums } from 'google-ads-node'

  Enums are exported as a nested object. Common mistake: trying to destructure enums incorrectly.

Quickstart

Shows how to create a GoogleAdsClient, instantiate a service stub, and run a GAQL query using the GoogleAdsService.

import { GoogleAdsClient, services, enums } from 'google-ads-node';

async function main() {
  const client = new GoogleAdsClient({
    developerToken: process.env.DEVELOPER_TOKEN ?? '',
    clientId: process.env.CLIENT_ID ?? '',
    clientSecret: process.env.CLIENT_SECRET ?? '',
    refreshToken: process.env.REFRESH_TOKEN ?? '',
  });

  const customerId = '1234567890';
  const campaignService = new services.GoogleAdsServiceClient(client);

  const request = {
    customerId: customerId,
    query: `SELECT campaign.id, campaign.name FROM campaign WHERE campaign.status = 'PAUSED'`,
  };

  try {
    const response = await campaignService.search(request);
    console.log(JSON.stringify(response, null, 2));
  } catch (err) {
    console.error(err.errors);
  }
}

main();