Method: projects.locations.authorizations.acquireUserAuthorization

Verwendet das gespeicherte Aktualisierungstoken für den Nutzer, der durch seine Endnutzeranmeldedaten und die angegebene Ressource identifiziert wird, und gibt das generierte Zugriffstoken und seine Details zurück. Ruft das Zugriffstoken aus dem Cache ab, falls verfügbar. Das gespeicherte Aktualisierungstoken wird bei Bedarf rotiert.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Ressourcenname von Authorization. Format: projects/{project}/locations/{location}/authorizations/{authorization}

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für die Methode AuthorizationService.AcquireUserAuthorization.

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "refreshTokenInfo": {
    object (RefreshTokenInfo)
  },
  "accessToken": string,
  "authorizationUri": string
}
Felder
refreshTokenInfo

object (RefreshTokenInfo)

Informationen zum gespeicherten Aktualisierungstoken, das zum Erstellen des Zugriffstokens verwendet wurde

accessToken

string

Das erstellte Zugriffstoken

authorizationUri

string

Eine URI, die den Autorisierungsablauf auslöst. Wird festgelegt, wenn der Nutzer (neu) autorisiert werden muss.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource name:

  • discoveryengine.authorizations.storeUserAuthorization

Weitere Informationen finden Sie in der IAM-Dokumentation.

RefreshTokenInfo

Beschreibt ein Aktualisierungstoken.

JSON-Darstellung
{
  "scopes": [
    string
  ]
}
Felder
scopes[]

string

Die Liste der Bereiche für dieses Token.