The Postmaster Tools API is a RESTful API that provides programmatic access to email traffic metrics (like spam reports, delivery errors etc) otherwise available through the Gmail Postmaster Tools UI currently. For detailed description please check documentation.

Installing

Install typings for Gmail Postmaster Tools API:

npm install @types/gapi.client.gmailpostmastertools-v1beta1 --save-dev

Usage

You need to initialize Google API client in your code:

gapi.load('client', () => {
  // now we can use gapi.client
  // ...
});

Then load api client wrapper:

gapi.client.load('https://gmailpostmastertools.googleapis.com/$discovery/rest?version=v1beta1', () => {
  // now we can use:
  // gapi.client.gmailpostmastertools
});

// Deprecated, use discovery document URL, see https://github.com/google/google-api-javascript-client/blob/master/docs/reference.md#----gapiclientloadname----version----callback--
gapi.client.load('gmailpostmastertools', 'v1beta1', () => {
  // now we can use:
  // gapi.client.gmailpostmastertools
});

Don't forget to authenticate your client before sending any request to resources:

// declare client_id registered in Google Developers Console
var client_id = '',
  scope = [
      // See email traffic metrics for the domains you have registered in Gmail Postmaster Tools
      'https://www.googleapis.com/auth/postmaster.readonly',
    ],
    immediate = true;
// ...

gapi.auth.authorize(
  { client_id: client_id, scope: scope, immediate: immediate },
  authResult => {
    if (authResult && !authResult.error) {
        /* handle successful authorization */
    } else {
        /* handle authorization error */
    }
});

After that you can use Gmail Postmaster Tools API resources:


/*
Gets a specific domain registered by the client. Returns NOT_FOUND if the domain does not exist.
*/
await gapi.client.gmailpostmastertools.domains.get({ name: "name",  });

/*
Lists the domains that have been registered by the client. The order of domains in the response is unspecified and non-deterministic. Newly created domains will not necessarily be added to the end of this list.
*/
await gapi.client.gmailpostmastertools.domains.list({  });

FAQs

What is @maxim_mazurok/gapi.client.gmailpostmastertools-v1beta1?

Is @maxim_mazurok/gapi.client.gmailpostmastertools-v1beta1 popular?

Is @maxim_mazurok/gapi.client.gmailpostmastertools-v1beta1 well maintained?

Last updated on 24 Mar 2023

Did you know?

Socket installs a Github app to automatically flag issues on every pull request and report the health of your dependencies. Find out what is inside your node modules and prevent malicious activity before you update the dependencies.

Install Socket