Method: projects.locations.collections.dataConnector.acquireAccessToken

Utilizza il token di aggiornamento per utente creato con dataConnector.acquireAndStoreRefreshToken per generare e restituire un nuovo token di accesso e i relativi dettagli. Prende il token di accesso dalla cache, se disponibile. Ruota il token di aggiornamento memorizzato, se necessario. Utilizza l'identità dell'utente finale per restituire il token di accesso specifico dell'utente. Non restituisce le credenziali configurate dall'amministratore. Utilizzato dall'esecuzione delle azioni e dall'interfaccia utente.

Richiesta HTTP


POST https://discoveryengine.googleapis.com/v1alpha/{name=projects/*/locations/*/collections/*/dataConnector}:acquireAccessToken

Gli URL utilizzano la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
name

string

Obbligatorio. Il nome della risorsa del connettore per il quale viene eseguita una query per un token.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "scope": string,
  "action": string
}
Campi
scope

string

Facoltativo. L'ambito per richiedere il token di accesso. L'ambito sostituirà l'ambito predefinito se specificato.

action

string

Facoltativo. Il nome dello strumento/dell'azione in esecuzione. Se fornito, il server controllerà gli ambiti richiesti dell'azione e attiverà dinamicamente l'autorizzazione incrementale se mancano.

Corpo della risposta

Messaggio di risposta per il metodo DataConnectorService.AcquireAccessToken.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "refreshTokenInfo": {
    object (RefreshTokenInfo)
  },
  "accessToken": string
}
Campi
refreshTokenInfo

object (RefreshTokenInfo)

Informazioni sul token di aggiornamento archiviato utilizzato per creare il token di accesso.

accessToken

string

Il token di accesso creato.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per saperne di più, consulta la Authentication Overview.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa name:

  • discoveryengine.dataConnectors.acquireAccessToken

Per saperne di più, consulta la documentazione di IAM.