Google Ad Manager API Client Library for NodeJs.
Forked from https://github.com/Niurmiguel/google-admanager-api as the original package was not maintained.
Developers can use the Google Ad Manager API to build applications that manage inventory, create orders, pull reports, and more.
$ npm install @guardian/google-admanager-api
$ yarn add @guardian/google-admanager-api
$ pnpm add @guardian/google-admanager-api
All Google Ad Manager API calls must be authorized through OAuth2 an open standard that allows users to grant permissions to third-party applications, so the application can interact with web services on the user's behalf. OAuth2 enables your Ad Manager API client application to access a user's Ad Manager account without having to handle or store the user's username or password.
const credential = new GoogleSACredential({
"type": "service_account",
"project_id": "...",
"private_key_id": "...",
"private_key": "...",
"client_email": "...",
"client_id": "...",
"auth_uri": "...",
"token_uri": "...",
...
});
//or
const credential = new GoogleSAFileCredential('./credentials.json');
Using the API on behalf of a real user is slightly more complicated than using a service account. The user must grant your application access to their Ad Manager account. This is done by redirecting the user to Google's OAuth2 consent screen, where they will be asked to grant your application access to their Ad Manager account.
There is an example of how to generate user account credentials in the example folder.
It uses the refresh token generation example to generate the refresh token.
There is also an option to use an access token directly. As access tokens are short-lived, you will need to refresh them yourself.
const adManagerClient = new AdManagerClient('networkCode',credential,'applicationName');
const orderService = await adManagerClient.getService("OrderService");
const statement = new StatementBuilder().limit(10);
const orderPage = await orderService.getOrdersByStatement(statement.toStatement())
/**
* {
* results: [],
* totalResultSetSize: 0,
* startIndex: 0
* }
* /
networkCode |
Number |
The network code of the network being addressed (required). |
credential |
SACredential |
OAuth2 credential (required). |
applicationName |
String |
An arbitrary string name identifying your application. This will be shown in Google's log files. For example: "My Inventory Application" or "App_1" (optional). |