Manually query member and order details with the Monetization API

Publishers can use the Monetization API to find out more information about members and orders using the Monetization API. Unlike the Publication API, the Monetization API uses service accounts for server-to-server authentication, rather than user-scoped access_token authentication.

API Tests

Each of the following buttons requires a readerId to function. To properly test these, you can use the Add Subscribe with Google button example to purchase an entitlement, and the Publication API example to get your readerId.

After setting a readerId, the buttons will become available.

Implementation Samples

While most of the logic for using the Publication API can be done client-side, certain aspects of the OAuth flow must be done server-side. The following code samples are split across the client and server, illustrating the type of logic that should happen at each layer.

Server-side code sample

After configuring your application to be able to use a service account, you can use the generated API client to access the Monetization API.

import subscribewithgoogle from '@googleapis/subscribewithgoogle';

/**
 * MonetizationApi
 * A sample class that uses the GoogleApis node.js client and a service
 * account for interacting with the Publication API.
 */
class MonetizationApi {
  constructor() {
    this.auth = new subscribewithgoogle.auth.GoogleAuth({
      keyFile: process.env.GOOGLE_APPLICATION_CREDENTIALS,
      scopes: [
        'https://www.googleapis.com/auth/subscribewithgoogle.publications.entitlements.readonly'
      ],
    })
  }

  init() {
    return new subscribewithgoogle.subscribewithgoogle(
        {version: 'v1', auth: this.auth})
  }
}

const api = new MonetizationApi;
const client = api.init();

const readerId = '' //Pull from the Publication APi

const base = `publications/${process.env.PUBLICATION_ID}`;
const endpoint = `readers/${readerId}`;
const name = `${base}/${endpoint}`;
const reader = await client.publications.readers.get({name});