feat(sts): update the api

#### sts:v1

The following keys were added:
- resources.v1.methods.introspect (Total Keys: 7)
- schemas.GoogleIdentityStsV1IntrospectTokenRequest (Total Keys: 4)
- schemas.GoogleIdentityStsV1IntrospectTokenResponse (Total Keys: 12)

Author: yoshi-automation

docs/dyn/sts_v1.v1.html

@@ -77,6 +77,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#close">close()</a></code></p>
 <p class="firstline">Close httplib2 connections.</p>
+<p class="toc_element">
+  <code><a href="#introspect">introspect(body=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets information about a Google OAuth 2.0 access token issued by the Google Cloud [Security Token Service API](https://cloud.google.com/iam/docs/reference/sts/rest).</p>
 <p class="toc_element">
   <code><a href="#token">token(body=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Exchanges a credential for a Google OAuth 2.0 access token. The token asserts an external identity within a workload identity pool, or it applies a Credential Access Boundary to a Google access token. 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.</p>
@@ -86,6 +89,39 @@ <h3>Method Details</h3>
   <pre>Close httplib2 connections.</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="introspect">introspect(body=None, x__xgafv=None)</code>
+  <pre>Gets information about a Google OAuth 2.0 access token issued by the Google Cloud [Security Token Service API](https://cloud.google.com/iam/docs/reference/sts/rest).
+
+Args:
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for IntrospectToken.
+  &quot;token&quot;: &quot;A String&quot;, # Required. The OAuth 2.0 security token issued by the Security Token Service API.
+  &quot;tokenTypeHint&quot;: &quot;A String&quot;, # Optional. The type of the given token. Supported values are `urn:ietf:params:oauth:token-type:access_token` and `access_token`.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for IntrospectToken.
+  &quot;active&quot;: True or False, # A boolean value that indicates whether the provided access token is currently active.
+  &quot;client_id&quot;: &quot;A String&quot;, # The client identifier for the OAuth 2.0 client that requested the provided token.
+  &quot;exp&quot;: &quot;A String&quot;, # The expiration timestamp, measured in the number of seconds since January 1 1970 UTC, indicating when this token will expire.
+  &quot;iat&quot;: &quot;A String&quot;, # The issued timestamp, measured in the number of seconds since January 1 1970 UTC, indicating when this token was originally issued.
+  &quot;iss&quot;: &quot;A String&quot;, # The issuer of the provided token.
+  &quot;scope&quot;: &quot;A String&quot;, # A list of scopes associated with the provided token.
+  &quot;sub&quot;: &quot;A String&quot;, # The unique user ID associated with the provided token. For Google Accounts, this value is based on the Google Account&#x27;s user ID. For federated identities, this value is based on the identity pool ID and the value of the mapped `google.subject` attribute.
+  &quot;username&quot;: &quot;A String&quot;, # The human-readable identifier for the token principal subject. For example, if the provided token is associated with a workload identity pool, this field contains a value in the following format: `principal://iam.googleapis.com/projects//locations/global/workloadIdentityPools//subject/`
+}</pre>
+</div>
+
 <div class="method">
     <code class="details" id="token">token(body=None, x__xgafv=None)</code>
   <pre>Exchanges a credential for a Google OAuth 2.0 access token. The token asserts an external identity within a workload identity pool, or it applies a Credential Access Boundary to a Google access token. 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.

googleapiclient/discovery_cache/documents/sts.v1.json

@@ -98,6 +98,21 @@
   "resources": {
     "v1": {
       "methods": {
+        "introspect": {
+          "description": "Gets information about a Google OAuth 2.0 access token issued by the Google Cloud [Security Token Service API](https://cloud.google.com/iam/docs/reference/sts/rest).",
+          "flatPath": "v1/introspect",
+          "httpMethod": "POST",
+          "id": "sts.introspect",
+          "parameterOrder": [],
+          "parameters": {},
+          "path": "v1/introspect",
+          "request": {
+            "$ref": "GoogleIdentityStsV1IntrospectTokenRequest"
+          },
+          "response": {
+            "$ref": "GoogleIdentityStsV1IntrospectTokenResponse"
+          }
+        },
         "token": {
           "description": "Exchanges a credential for a Google OAuth 2.0 access token. The token asserts an external identity within a workload identity pool, or it applies a Credential Access Boundary to a Google access token. 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.",
           "flatPath": "v1/token",
@@ -116,7 +131,7 @@
       }
     }
   },
-  "revision": "20210827",
+  "revision": "20210910",
   "rootUrl": "https://sts.googleapis.com/",
   "schemas": {
     "GoogleIamV1Binding": {
@@ -236,6 +251,62 @@
       },
       "type": "object"
     },
+    "GoogleIdentityStsV1IntrospectTokenRequest": {
+      "description": "Request message for IntrospectToken.",
+      "id": "GoogleIdentityStsV1IntrospectTokenRequest",
+      "properties": {
+        "token": {
+          "description": "Required. The OAuth 2.0 security token issued by the Security Token Service API.",
+          "type": "string"
+        },
+        "tokenTypeHint": {
+          "description": "Optional. The type of the given token. Supported values are `urn:ietf:params:oauth:token-type:access_token` and `access_token`.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "GoogleIdentityStsV1IntrospectTokenResponse": {
+      "description": "Response message for IntrospectToken.",
+      "id": "GoogleIdentityStsV1IntrospectTokenResponse",
+      "properties": {
+        "active": {
+          "description": "A boolean value that indicates whether the provided access token is currently active.",
+          "type": "boolean"
+        },
+        "client_id": {
+          "description": "The client identifier for the OAuth 2.0 client that requested the provided token.",
+          "type": "string"
+        },
+        "exp": {
+          "description": "The expiration timestamp, measured in the number of seconds since January 1 1970 UTC, indicating when this token will expire.",
+          "format": "int64",
+          "type": "string"
+        },
+        "iat": {
+          "description": "The issued timestamp, measured in the number of seconds since January 1 1970 UTC, indicating when this token was originally issued.",
+          "format": "int64",
+          "type": "string"
+        },
+        "iss": {
+          "description": "The issuer of the provided token.",
+          "type": "string"
+        },
+        "scope": {
+          "description": "A list of scopes associated with the provided token.",
+          "type": "string"
+        },
+        "sub": {
+          "description": "The unique user ID associated with the provided token. For Google Accounts, this value is based on the Google Account's user ID. For federated identities, this value is based on the identity pool ID and the value of the mapped `google.subject` attribute.",
+          "type": "string"
+        },
+        "username": {
+          "description": "The human-readable identifier for the token principal subject. For example, if the provided token is associated with a workload identity pool, this field contains a value in the following format: `principal://iam.googleapis.com/projects//locations/global/workloadIdentityPools//subject/`",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "GoogleIdentityStsV1Options": {
       "description": "An `Options` object configures features that the Security Token Service supports, but that are not supported by standard OAuth 2.0 token exchange endpoints, as defined in https://tools.ietf.org/html/rfc8693.",
       "id": "GoogleIdentityStsV1Options",

googleapiclient/discovery_cache/documents/sts.v1beta.json

@@ -116,7 +116,7 @@
       }
     }
   },
-  "revision": "20210827",
+  "revision": "20210910",
   "rootUrl": "https://sts.googleapis.com/",
   "schemas": {
     "GoogleIamV1Binding": {