@maxim_mazurok/gapi.client.sts-v1 v0.0.20240501

TypeScript typings for Security Token Service API v1

The Security Token Service exchanges Google or third-party credentials for a short-lived access token to Google Cloud resources. For detailed description please check documentation.

Installing

Install typings for Security Token Service API:

npm install @types/gapi.client.sts-v1 --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://sts.googleapis.com/$discovery/rest?version=v1',
  () => {
    // now we can use:
    // gapi.client.sts
  }
);

// 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('sts', 'v1', () => {
  // now we can use:
  // gapi.client.sts
});

After that you can use Security Token Service API resources:

/*
Exchanges a credential for a Google OAuth 2.0 access token. The token asserts an external identity within an identity pool, or it applies a Credential Access Boundary to a Google access token. Note that workforce pools do not support Credential Access Boundaries. When you call this method, do not send the `Authorization` HTTP header in the request. This method does not require the `Authorization` header, and using the header can cause the request to fail.
*/
await gapi.client.sts.token({});