REST Resource: projects.locations.authorizations

Ressource: Autorisierung

Discovery Engine-Autorisierungsressource.

JSON-Darstellung 
{
  "name": string,
  "displayName": string,

  // Union field authorization_config can be only one of the following:
  "serverSideOauth2": {
    object (ServerSideOAuth2)
  }
  // End of list of possible types for union field authorization_config.
}
Felder
name

string

ID. Ressourcenname der Autorisierung. Format: projects/{project}/locations/{location}/authorizations/{authorization}

Es muss ein UTF-8-codierter String mit einer Längenbeschränkung von 1.024 Zeichen sein.
displayName

string

Erforderlich. Der Anzeigename der Autorisierung.

Es muss ein UTF-8-codierter String mit einer Längenbeschränkung von 128 Zeichen sein.
Union-Feld authorization_config. Die Autorisierungskonfiguration. Für authorization_config ist nur einer der folgenden Werte zulässig:
serverSideOauth2

object (ServerSideOAuth2)

Serverseitige OAuth2-Konfiguration.

ServerSideOAuth2

OAuth-Konfiguration.

JSON-Darstellung 
{
  "clientId": string,
  "clientSecret": string,
  "tokenUri": string,
  "authorizationUri": string,
  "scopes": [
    string
  ]
}
Felder
clientId

string

Erforderlich. Die OAuth2-Client-ID.
clientSecret

string

Erforderlich. Der OAuth2-Clientschlüssel.

Im Ruhezustand verschlüsselt.
tokenUri

string

Erforderlich. Der HTTP-Endpunkt, der eine Clientautorisierung gegen ein Zugriffstoken tauscht.
authorizationUri

string

Erforderlich. Die URI, zu der der Nutzer weitergeleitet wird, wenn er sich autorisieren muss. Sie sollte alle Angaben für die erfolgreiche Autorisierung enthalten, also OAuth-ID, zusätzliche Flags usw. Beispiel: https://accounts.google.com/o/oauth2/v2/auth?clientId=OAUTH_ID&scope=https://www.googleapis.com/auth/calendar.events&responseType=code&access_type=offline&prompt=consent

Der Parameter redirectUri wird vom Vertex AI Search-Frontend überschrieben.
scopes[]

string

Erforderlich. Die Bereiche, die angefordert werden sollen. Beispiel: https://www.googleapis.com/auth/calendar.events

Methoden

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.

create

 Erstellt einen Authorization

delete

 Löscht einen Authorization.

get

 Ruft einen Authorization ab.

list

 Listet alle Authorizations unter einer Engine auf.

patch

 Aktualisiert einen Authorization.

storeUserAuthorization

 Tauscht OAuth-Anmeldedaten für die Autorisierung gegen ein Aktualisierungstoken ein und speichert das Aktualisierungstoken und die Bereiche.