@maxim_mazurok/gapi.client.webmasters
TypeScript icon, indicating that this package has built-in type declarations

3.0.20190428 • Public • Published

TypeScript typings for Search Console API v3

View Google Search Console data for your verified sites. For detailed description please check documentation.

Installing

Install typings for Search Console API:

npm install @types/gapi.client.webmasters@v3 --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('webmasters', 'v3', () => {
  // now we can use gapi.client.webmasters
  // ...
});

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 = [ 
      // View and manage Search Console data for your verified sites
      'https://www.googleapis.com/auth/webmasters',

      // View Search Console data for your verified sites
      'https://www.googleapis.com/auth/webmasters.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 Search Console API resources:

/*
Query your data with filters and parameters that you define. Returns zero or more rows grouped by the row keys that you define. You must define a date range of one or more days.

When date is one of the group by values, any days without data are omitted from the result list. If you need to know which days have data, issue a broad date range query grouped by date for any metric, and see which day rows are returned.
*/
await gapi.client.webmasters.searchanalytics.query({ siteUrl: "siteUrl",  });

/*
Deletes a sitemap from this site.
*/
await gapi.client.webmasters.sitemaps.delete({ feedpath: "feedpath", siteUrl: "siteUrl",  });

/*
Retrieves information about a specific sitemap.
*/
await gapi.client.webmasters.sitemaps.get({ feedpath: "feedpath", siteUrl: "siteUrl",  });

/*
Lists the sitemaps-entries submitted for this site, or included in the sitemap index file (if sitemapIndex is specified in the request).
*/
await gapi.client.webmasters.sitemaps.list({ siteUrl: "siteUrl",  });

/*
Submits a sitemap for a site.
*/
await gapi.client.webmasters.sitemaps.submit({ feedpath: "feedpath", siteUrl: "siteUrl",  });

/*
Adds a site to the set of the user's sites in Search Console.
*/
await gapi.client.webmasters.sites.add({ siteUrl: "siteUrl",  });

/*
Removes a site from the set of the user's Search Console sites.
*/
await gapi.client.webmasters.sites.delete({ siteUrl: "siteUrl",  });

/*
Retrieves information about specific site.
*/
await gapi.client.webmasters.sites.get({ siteUrl: "siteUrl",  });

/*
Lists the user's Search Console sites.
*/
await gapi.client.webmasters.sites.list({  });

Readme

Keywords

none

Package Sidebar

Install

npm i @maxim_mazurok/gapi.client.webmasters

Weekly Downloads

20

Version

3.0.20190428

License

MIT

Unpacked Size

27.9 kB

Total Files

6

Last publish

Collaborators

  • maxim_mazurok