Package Exports

google-ad-manager-api

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (google-ad-manager-api) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Google Ad Manager Node.js API

A modern wrapper around Google's Ad Manager API.

Features

Promise based - use Promise or async/await
Non opinionated about auth mechanisms - obtain a token however you like
Typed (TypeScript)

Install

npm i --save google-ad-manager-api

Usage

Step #1

Obtain an access token in whatever way you like, for example using Google Auth Library's JSON Web Tokens mechanism:

const {auth} = require('google-auth-library');

const keys = {
    "type": "service_account",
    "project_id": "...",
    "private_key_id": "...",
    "private_key": "...",
    "client_email": "...",
    "client_id": "...",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
    "client_x509_cert_url": "..."
};

const client = auth.fromJSON(keys);
client.scopes = ['https://www.googleapis.com/auth/dfp'];
await client.authorize();

Step #2:

Create a DFP client:

import {DFP} from 'google-ad-manager-api';
const dfp = new DFP({networkCode: '...', apiVersion: 'v201805'});

Step #3

Use the client to create a service, and pass the auth token from step #1:

const lineItemService = await dfp.getService('LineItemService');
lineItemService.setToken(client.credentials.access_token);

Or even shorter (pass the token directly to getService:

const lineItemService = await dfp.getService('LineItemService', client.credentials.access_token);

Step #4

Invoke service methods:

const res = await lineItemService.getLineItemsByStatement({
    filterStatement: {
        query: "WHERE name LIKE 'prebid%'"
    }
});

console.log(res.results[0].id);

Notes

The Ad Manager API returns an rval field for each method invocation. To make things easier for us, this package will return the content of that field. For example, invocation of LineItemService.getLineItemsByStatement will return a LineItemPage object directly.
Google auth tokens have expiration dates and they need to be updated or refreshed in some way. Because authentication management is outside the scope of this package, make sure to always pass the new tokens to the services instances using service.setToken.