Connessione a Google Drive

Google Drive è una piattaforma di archiviazione file e collaborazione basata su cloud che consente agli utenti di archiviare, condividere e modificare insieme i documenti in tempo reale da qualsiasi dispositivo. L'integrazione di Google Drive con IBM watsonx Orchestrate consente un accesso senza interruzioni a file e cartelle per l'automazione, lo scambio di dati e l'orchestrazione dei flussi di lavoro.

Per integrare Google Drive con IBM e watsonx Orchestrate, è necessario stabilire una connessione sicura che consenta ai due sistemi di comunicare senza interruzioni. Per indicazioni generali sulla gestione delle integrazioni, consultare la sezione "Collegamento delle app per gli agenti predefiniti ".

Importante:

Per impostazione predefinita, il Single Sign-On (SSO) è disattivato per la tua app. Per abilitarlo, consultare la sezione "Configurazione del Single Sign-On per le applicazioni".

Passaggi per la connessione

Segui questi passaggi per collegare Google Drive a watsonx Orchestrate :

  1. Vai su Gestisci > Connessioni e cerca l 'ID connessione Google Drive corrispondente.

  2. Fai clic su Modifica accanto all'ID connessione corrispondente.

  3. Seleziona il metodo di autenticazione utilizzato dalla tua organizzazione ( OAuth 2.0 o Key Value Pair ).

  4. Inserisci i campi specifici dell' Google Drive in base al metodo di autenticazione selezionato. Per informazioni sul flusso di lavoro generale relativo alla connessione, consultare la pagina "Connessione delle app per agenti predefiniti".

  5. Completa i passaggi relativi alla bozza e alla configurazione live.

  6. Salva e verifica la connessione per confermare che sia stata stabilita correttamente.

Metodi di autenticazione supportati

Google Drive supporta i seguenti tipi di autenticazione in watsonx Orchestrate :

  1. OAuth 2.0 (Codice di autorizzazione) : consigliato per connessioni di produzione

  2. Coppia chiave-valore (KVP) : supportata per scenari basati su chiavi API e legacy

Nota:

Per gli agenti creati dopo settembre 2025, OAuth 2.0 è l'unico metodo di autenticazione supportato per Google Drive.

ID connessione

Utilizza i seguenti ID di connessione quando individui la tua connessione Google Drive nella pagina delle impostazioni delle connessioni. Per capire come cercare un ID connessione e aprire una connessione per la modifica, consulta Collegamento di app per agenti predefiniti.

Tipo di autenticazione

ID connessione

OAuth2 Codice di autorizzazione

``google_oauth2_auth_code_ibm_184bdbd3``

Coppia chiave-valore

``google_key_value_ibm_184bdbd3`` (obsoleto)

OAuth 2.0 dettagli di connessione

Se la tua organizzazione utilizza l'autenticazione basata su OAuth, imposta il tipo di autenticazione su Codice di autorizzazion OAuth2 e inserisci i seguenti campi:

Campo

Descrizione

URL del server

Base URL del server Google Drive

URL token

Endpoint per scambiare il codice di autorizzazione con un token di accesso

Ambito

Definisce l'accesso richiesto

Autorizzazione URL

URL dove gli utenti vengono reindirizzati per effettuare il login e autorizzare l'accesso

ID client

ID univoco per la vostra applicazione

Segreto client

Una chiave segreta utilizzata per l'autenticazione dell'applicazione con Google Drive

È possibile ottenere questi valori dalla console di gestione di Azure ( Google Cloud ). Per ulteriori dettagli, consultare la documentazione relativa all'API di autenticazione di Google.

Dettagli della connessione della coppia chiave-valore

Se la tua organizzazione utilizza chiavi API o una configurazione legacy, imposta il tipo di autenticazione su Coppia chiave-valore e aggiungi ciascuno dei seguenti campi utilizzando Aggiungi nuovo campo :

Chiave

Descrizione

base_url

La base URL per Google Drive API (per esempio, https://www.googleapis.com)

token_url

L' URL utilizzato per ottenere il token OAuth (ad esempio, https://oauth2.googleapis.com/token)

client_id

ID cliente del progetto Google Cloud

client_secret

Il segreto del cliente del vostro progetto Google Cloud

bearer_token

Il token di accesso utilizzato per le richieste API

refresh_token

Il token utilizzato per aggiornare il token del portatore alla sua scadenza

Nota : quando si utilizza la coppia chiave-valore, sono supportate solo le credenziali del team.

È possibile ottenere questi valori dalla console di gestione di Azure ( Google Cloud ). Per ulteriori dettagli, consultare la documentazione relativa all'API di autenticazione di Google.