Method: projects.locations.authorizations.acquireUserAuthorization

エンドユーザー認証情報と特定のリソースによって識別されるユーザーの保存済み更新トークンを使用して、生成されたアクセス トークンとその詳細を返します。利用可能であればキャッシュからアクセス トークンを取得します。必要に応じて、保存されている更新トークンをローテーションします。

HTTP リクエスト

POST https://discoveryengine.googleapis.com/v1alpha/{name=projects/*/locations/*/authorizations/*}:acquireUserAuthorization

この URL では gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
name

string

必須。Authorization のリソース名。形式: projects/{project}/locations/{location}/authorizations/{authorization}

リクエストの本文

リクエスト本文は空にする必要があります。

レスポンスの本文

[AuthorizationService.AcquireAuthorization][] メソッドのレスポンス メッセージ。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "refreshTokenInfo": {
    object (RefreshTokenInfo)
  },
  "accessToken": string,
  "authorizationUri": string
}
フィールド
refreshTokenInfo

object (RefreshTokenInfo)

アクセス トークンの作成に使用された保存済みの更新トークンに関する情報。
accessToken

string

作成されたアクセス トークン。
authorizationUri

string

認証フローをトリガーする URI。ユーザーの（再）認証が必要なときに設定します。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite

詳細については、Authentication Overview をご覧ください。

RefreshTokenInfo

更新トークンの説明を取得します。

JSON 表現 
{
  "scopes": [
    string
  ]
}
フィールド
scopes[]

string

このトークンのスコープのリスト。