REST Resource: projects.locations.authorizations

Recurso: Authorization

Es el recurso de autorización de Discovery Engine.

Representación JSON 
{
  "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.
}
Campos
name

string

Es el identificador. Es el nombre del recurso de la autorización. Formato: projects/{project}/locations/{location}/authorizations/{authorization}

Debe ser una cadena codificada en UTF-8 con un límite de 1,024 caracteres.
displayName

string

Obligatorio. Es el nombre visible de la autorización.

Debe ser una cadena codificada en UTF-8 con un límite de 128 caracteres.
Campo de unión authorization_config. Es la configuración de autorización. authorization_config puede ser solo uno de los siguientes:
serverSideOauth2

object (ServerSideOAuth2)

Es la configuración de OAuth2 del servidor.

ServerSideOAuth2

Es la configuración de OAuth2.

Representación JSON 
{
  "clientId": string,
  "clientSecret": string,
  "tokenUri": string,
  "authorizationUri": string,
  "scopes": [
    string
  ]
}
Campos
clientId

string

Obligatorio. Es el ID de cliente de OAuth2.
clientSecret

string

Obligatorio. Es el secreto del cliente de OAuth2.

Se encriptan en reposo.
tokenUri

string

Obligatorio. Es el extremo HTTP que intercambia una autorización del cliente por un token de acceso.
authorizationUri

string

Obligatorio. Es el URI al que se dirige al usuario cuando necesita autorizar. Debe incluir todo lo necesario para una autorización exitosa: ID de OAuth, marcas adicionales, etcétera. Ejemplo: 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

El parámetro redirectUri se anulará con el frontend de Vertex AI Search.
scopes[]

string

Obligatorio. Son los permisos que se solicitarán. Ejemplo: https://www.googleapis.com/auth/calendar.events

Métodos

acquireUserAuthorization

 Usa el token de actualización almacenado para el usuario identificado por sus credenciales de usuario final y el recurso determinado, y devuelve el token de acceso generado y sus detalles.

create

 Crea un Authorization.

delete

 Borra un Authorization.

get

 Obtiene un Authorization.

list

 Enumera todos los Authorization en un Engine.

patch

 Actualiza un Authorization

storeUserAuthorization

 Intercambia credenciales de autorización de OAuth por un token de actualización y almacena el token de actualización y los permisos.