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ängenbegrenzung 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

OAuth2-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.

Verschlüsselung inaktiver Daten.
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 eine Autorisierung benötigt. Sollte alles enthalten, was für eine erfolgreiche Autorisierung erforderlich ist: 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 anzufordernden Bereiche. 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 ein Authorization.

delete

 Löscht ein Authorization.

get

 Ruft ein Authorization ab.

list

 Listet alle Authorizations unter einem Engine auf.

patch

 Aktualisiert eine Authorization

storeUserAuthorization

 Tauscht OAuth-Autorisierungsanmeldedaten gegen ein Aktualisierungstoken ein und speichert das Aktualisierungstoken und die Bereiche.