Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Connettore di azione Google Drive
Con il connettore di azione di Google Drive, puoi accedere a Google Drive direttamente in Amazon Quick tramite linguaggio naturale. Puoi caricare e scaricare file, gestire cartelle, cercare contenuti e tenere traccia delle modifiche senza uscire da Amazon Quick.
Amazon Quick supporta diversi metodi di autenticazione per il connettore di azione di Google Drive. Scegli il metodo più adatto ai requisiti di sicurezza della tua organizzazione.
-
App OAuth predefinita: utilizza un'applicazione OAuth AWS gestita. Non sono necessarie credenziali aggiuntive. Ti autentichi direttamente con il tuo account Google.
-
App OAuth personalizzata: utilizza un client OAuth gestito dal cliente creato nella Google Cloud Console. Questa opzione offre alla tua organizzazione il pieno controllo sulla configurazione OAuth.
Per ulteriori informazioni sui metodi di autenticazione supportati da Amazon Quick, consultaMetodi di autenticazione.
Prima di iniziare
Assicurati di disporre di quanto segue prima di configurare l'integrazione.
-
Un account Google con accesso a Google Drive.
-
Per l'app OAuth personalizzata: accesso alla Google Cloud Console
sul sito Web di Google con le autorizzazioni per creare client OAuth. -
Per i requisiti di abbonamento ad Amazon Quick, consultaConfigura le integrazioni nella console.
Configurazione di Google Cloud
Se utilizzi l'autenticazione predefinita dell'app OAuth, salta questa sezione e consulta. Configurazione del connettore in Amazon Quick
Per l'autenticazione personalizzata dell'app OAuth, completa i seguenti passaggi in Google Cloud Console prima di configurare Amazon Quick. Quando abiliti l'API nel passaggio 3, cerca e abilita l'API di Google Drive.
Crea un client OAuth in Google Cloud Console
Crea un client OAuth nella Google Cloud Console per ottenere le credenziali client di cui hai bisogno per Amazon Quick. Per ulteriori informazioni, consulta Utilizzo di OAuth 2.0 per accedere alle API di Google sul sito Web di Google
-
Accedi alla Google Cloud Console
sul sito web di Google. -
Crea un nuovo progetto o seleziona un progetto esistente.
-
Nel riquadro di navigazione a sinistra, scegli API e servizi, quindi scegli Libreria. Cerca l'API richiesta dalla tua integrazione e scegli Abilita.
-
Scegli la schermata di consenso OAuth e scegli Inizia.
-
Configura la schermata di consenso:
-
Inserisci un nome per l'app e seleziona un'e-mail di assistenza utente.
-
Per Audience, scegli Interno (solo la tua organizzazione) o Esterno (qualsiasi utente Google).
-
Aggiungi i dati di contatto dello sviluppatore e scegli Crea.
-
-
Scegli Crea client OAuth.
-
Configura il client:
-
Per Tipo di applicazione, scegli Applicazione Web.
-
Inserisci un nome per il tuo cliente.
-
In URI di reindirizzamento autorizzati, aggiungi l'URL di callback di Amazon Quick:
https://{region}.quicksight.aws.amazon.com/sn/oauthcallback
-
-
Scegli Create (Crea).
-
Registra i seguenti valori. Ne hai bisogno quando configuri Amazon Quick.
-
ID cliente
-
Client secret
-
Ambiti consigliati
I seguenti ambiti vengono richiesti quando ti connetti a Google Drive.
| Scope | Description |
|---|---|
https://www.googleapis.com/auth/drive |
Legge e scrive file in Google Drive. |
https://www.googleapis.com/auth/drive.readonly |
Legge i file in Google Drive. |
https://www.googleapis.com/auth/drive.metadata.readonly |
Legge i metadati dei file in Google Drive. |
openid |
Autentica l'identità dell'utente. |
email |
Legge l'indirizzo e-mail dell'utente. |
Nota
Gli email ambiti openid e vengono inclusi automaticamente nel flusso di consenso OAuth per l'autenticazione dell'utente. Non sono necessari per OAuth. Service-to-Service
Configurazione del connettore in Amazon Quick
Connect dalla scheda Available
Se desideri utilizzare l'autenticazione predefinita dell'app OAuth, puoi connetterti direttamente dalla scheda Disponibile senza configurazioni aggiuntive.
-
Nella console Amazon Quick, scegli Connettori.
-
Nella scheda Disponibile, trova Google Drive e scegli Connect.
-
Completa il flusso di accesso a Google e concedi le autorizzazioni richieste.
Per configurare invece un connettore con l'app OAuth personalizzata, utilizza la scheda Crea per il tuo team come descritto di seguito.
Crea dalla scheda Crea per il tuo team
Dopo aver completato la configurazione richiesta di Google Cloud, crea il connettore in Amazon Quick.
-
Nella console Amazon Quick, scegli Connettori.
-
Scegli la scheda Crea per il tuo team.
-
Trova e scegli Google Drive.
Nota
Se esiste già un connettore Google Drive, viene visualizzata una finestra di dialogo con i connettori esistenti. Per utilizzare un connettore esistente, selezionalo. Per crearne uno nuovo, scegli No, crea nuovo.
-
Inserisci un nome per il connettore. Facoltativamente, scegli + Aggiungi descrizione per aggiungere una descrizione.
-
Per Tipo di connessione, scegli Rete pubblica.
-
Per la configurazione OAuth, scegli uno dei seguenti metodi di autenticazione e configura i campi richiesti.
-
Per l'app OAuth predefinita:
Non sono necessarie credenziali aggiuntive. Seleziona Successivo per continuare.
-
Per l'app OAuth personalizzata, configura i seguenti campi:
-
URL di base (opzionale): l'URL di base dell'API di Google Drive. Ad esempio:
https://www.googleapis.com/drive -
ID cliente: l'ID client del tuo client Google Cloud OAuth.
-
Segreto del cliente: il segreto del client Google Cloud OAuth.
-
URL del token: l'endpoint del token. Ad esempio:
https://oauth2.googleapis.com/token -
URL di autorizzazione: l'endpoint di autorizzazione. Ad esempio:
https://accounts.google.com/o/oauth2/v2/auth -
URL di reindirizzamento: Pre-filled con l'URL di callback di Amazon Quick.
-
-
-
Scegli Next (Successivo).
-
Se scegli l'app OAuth predefinita o l'app OAuth personalizzata, si apre una finestra di autorizzazione di Google. Controlla le autorizzazioni richieste e scegli Consenti.
-
Nella pagina Revisione, esamina le azioni disponibili per il connettore. Scegli Next (Successivo).
-
Nella pagina Pubblica, scegli chi può accedere al connettore. Puoi abilitare l'accesso per tutti i membri dell'organizzazione o cercare team o gruppi specifici.
-
Seleziona Pubblica.
Operazioni disponibili
Dopo aver configurato il connettore, sono disponibili le seguenti azioni.
| Categoria | Azione | Description |
|---|---|---|
| File | Ottieni file | Scarica un file da Google Drive. |
| File | Cerca nei file | Cerca file per nome o contenuto. |
| File | Ottieni i metadati dei file | Recupera i metadati di un file. |
| File | File di importazione | Carica un file su Google Drive. |
| File | Carica file da Url | Carica un file da un URL. |
| File | Creare file | Crea un nuovo file. |
| File | Crea file da testo | Crea un file dal contenuto di testo. |
| File | Inserisci file | Sostituisce il contenuto di un file esistente. |
| File | Aggiorna il contenuto del file | Modifica il contenuto di un file esistente. |
| File | Aggiorna la posizione del file | Sposta un file in una cartella diversa. |
| File | Copia il file | Crea una copia di un file. |
| File | File di esportazione | Esporta un file Google Workspace in un formato diverso. |
| File | Elimina file | Sposta un file nel cestino. |
| Cartelle | Create Folder | Crea una nuova cartella. |
| Cartelle | Cartelle di ricerca | Cerca le cartelle per nome. |
| Permissions | Elenca le autorizzazioni | Elenca le autorizzazioni per un file o una cartella. |
| Commenti | Elenca commenti | Elenca i commenti su un file. |
| Modifiche | Elenca le modifiche | Elenca le modifiche recenti ai file. |
| Modifiche | Ottieni il token della pagina iniziale delle modifiche | Recupera un token della pagina iniziale per tenere traccia delle modifiche. |
| Guidare | Ottieni informazioni su Drive | Recupera informazioni sul Drive dell'utente. |
Nota
Le azioni che puoi utilizzare dipendono dai file e dalle cartelle accessibili all'utente autenticato.
Gestione e risoluzione dei problemi
Per modificare, condividere o eliminare il connettore, consultaGestione delle integrazioni esistenti.
Problemi comuni di autenticazione di Google
-
Sign-in fallimenti (app OAuth predefinita o app OAuth personalizzata): verifica che il tuo account Google sia attivo e di poter accedere direttamente al
sito Web di Google. Per l'app Custom OAuth, verifica che l'URI di reindirizzamento nel tuo client Google Cloud OAuth corrisponda all'URL di callback di Amazon Quick. -
App bloccata dall'amministratore: se l'amministratore di Google Workspace limita l'accesso alle app di terze parti, potresti visualizzare un errore quando tenti di accedere. Contatta il tuo amministratore di Google Workspace per consentire l'app Amazon Quick.
-
Credenziali client non valide (app OAuth personalizzata): verifica che l'ID client e il segreto del client corrispondano ai valori del client OAuth di Google Cloud.
-
Il popup di autenticazione non riesce: verifica che il tuo browser consenta i popup dal dominio della console Amazon Quick. Prova a utilizzare un altro browser o a svuotare la cache del browser.
-
Autorizzazioni revocate: se in precedenza hai revocato Amazon Quick Access dalle impostazioni delle autorizzazioni del tuo account Google, devi autenticarti nuovamente modificando il connettore e accedendo nuovamente.
-
Limitazione della velocità delle API di Google: Google potrebbe limitare le richieste durante i periodi di utilizzo elevato. Se le azioni falliscono, riprova dopo qualche minuto.
Problemi con Google Drive-specific
-
API di Google Drive non abilitata: verifica che l'API di Google Drive sia abilitata nel tuo progetto Google Cloud in API e servizi, Libreria.
