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

# Integrazione con Gmail
<a name="gmail-integration"></a>

Con il connettore di azione di Gmail, puoi accedere a Gmail direttamente in Amazon Quick tramite linguaggio naturale. Puoi leggere e inviare e-mail, gestire etichette e bozze, organizzare discussioni e cercare contatti senza uscire da Amazon Quick.

Amazon Quick supporta diversi metodi di autenticazione per Gmail. 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, consulta[Metodi di autenticazione](quick-action-auth.md).

## Prima di iniziare
<a name="gmail-integration-prerequisites"></a>

Assicurati di disporre di quanto segue prima di configurare l'integrazione.
+ Un account Google con accesso a Gmail.
+ Per l'**app OAuth personalizzata**: accesso alla [Google Cloud Console sul sito Web di Google](https://console.cloud.google.com/) con le autorizzazioni per creare client OAuth.
+ Per i requisiti di abbonamento ad Amazon Quick, consulta[Configura le integrazioni nella console](integration-console-setup-process.md).

## Configurazione di Google Cloud
<a name="gmail-source-setup"></a>

Se utilizzi l'autenticazione **predefinita dell'app OAuth**, salta questa sezione e consulta. [Configurazione del connettore in Amazon Quick](#gmail-quicksuite-setup)

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 **Gmail**.

### Crea un client OAuth in Google Cloud Console
<a name="w2aac49c28c57c19b7"></a>

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](https://developers.google.com/identity/protocols/oauth2).

1. Accedi alla [Google Cloud Console](https://console.cloud.google.com/) sul sito web di Google.

1. Crea un nuovo progetto o seleziona un progetto esistente.

1. Nel riquadro di navigazione a sinistra, scegli **API e servizi**, quindi scegli **Libreria**. Cerca l'API richiesta dalla tua integrazione e scegli **Abilita.**

1. Scegli la **schermata di consenso OAuth** e scegli **Inizia**.

1. 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**.

1. Scegli **Crea client OAuth.**

1. 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`

1. Scegli **Create** (Crea).

1. Registra i seguenti valori. Ne hai bisogno quando configuri Amazon Quick.
   + **ID cliente**
   + **Client secret**

### Ambiti consigliati
<a name="gmail-oauth-scopes"></a>

I seguenti ambiti sono richiesti quando ti connetti a Gmail.


**Ambiti consigliati da Gmail**  

| Scope | Description | 
| --- | --- | 
| https://www.googleapis.com/auth/gmail.modify | Legge, invia e gestisce email ed etichette. | 
| https://www.googleapis.com/auth/gmail.send | Invia e-mail per conto dell'utente. | 
| https://www.googleapis.com/auth/contacts.readonly | Legge le informazioni di contatto. | 
| 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
<a name="gmail-quicksuite-setup"></a>

### Connect dalla scheda Available
<a name="gmail-quick-connect"></a>

Se desideri utilizzare l'autenticazione predefinita dell'app OAuth, puoi connetterti direttamente dalla scheda **Disponibile** senza configurazioni aggiuntive.

1. Nella console Amazon Quick, scegli **Connettori**.

1. Nella scheda **Disponibile**, trova **Gmail** e scegli **Connect**.

1. 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
<a name="gmail-full-setup"></a>

Dopo aver completato la configurazione richiesta di Google Cloud, crea il connettore in Amazon Quick.

1. Nella console Amazon Quick, scegli **Connettori**.

1. Scegli la scheda **Crea per il tuo team**.

1. Trova e scegli **Gmail**.
**Nota**  
Se esiste già un connettore Gmail, viene visualizzata una finestra di dialogo con i connettori esistenti. Per utilizzare un connettore esistente, selezionalo. Per crearne uno nuovo, scegli **No, crea nuovo**.

1. Inserisci un **nome** per il connettore. Facoltativamente, scegli **\+ Aggiungi descrizione** per aggiungere una descrizione.

1. Per **Tipo di connessione**, scegli **Rete pubblica**.

1. Per la **configurazione OAuth**, scegli uno dei seguenti metodi di autenticazione e configura i campi richiesti.

   1. Per l'app **OAuth predefinita:**

      Non sono necessarie credenziali aggiuntive. Seleziona **Successivo** per continuare.

   1. Per l'**app OAuth personalizzata**, configura i seguenti campi:
      + **URL di base** (opzionale): l'URL di base dell'API Gmail. Ad esempio: `https://gmail.googleapis.com`
      + **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.

1. Scegli **Next (Successivo)**.

1. 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.**

1. Nella pagina **Revisione**, esamina le azioni disponibili per il connettore. Scegli **Next (Successivo)**.

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

1. Seleziona **Pubblica**.

## Operazioni disponibili
<a name="gmail-integration-actions"></a>

Dopo aver configurato il connettore, sono disponibili le seguenti azioni.


**Azioni disponibili in Gmail**  

| Categoria | Azione | Description | 
| --- | --- | --- | 
| Messaggi | Ricevi email | Recupera le email dalla casella di posta. | 
| Messaggi | Ottieni messaggio in base all'ID del thread | Recupera un messaggio in base all'ID del thread. | 
| Messaggi | Ricevi messaggio in base all'ID del messaggio | Recupera un messaggio in base all'ID del messaggio. | 
| Messaggi | Invio di e-mail | Invia un nuovo messaggio di posta elettronica. | 
| Messaggi | Invia risposta al thread | Risposte a un thread di posta elettronica esistente. | 
| Messaggi | Inoltra messaggio | Inoltra un'e-mail ad altri destinatari. | 
| Messaggi | Ottieni allegato | Recupera un allegato e-mail. | 
| Messaggi | Messaggio di aggiornamento in batch | Modifica le etichette su più messaggi in un'unica operazione. | 
| Thread | Elenca i thread | Elenca i thread di posta elettronica nella casella di posta. | 
| Thread | Aggiorna le etichette dei thread | Modifica le etichette su un thread. | 
| Cestino | Elimina e-mail | Sposta un'email nel cestino. | 
| Cestino | Elimina thread | Sposta un thread nel cestino. | 
| Cestino | Ripristina messaggio | Ripristina un'e-mail dal cestino. | 
| Cestino | Ripristina thread | Ripristina un thread dal cestino. | 
| Etichette | Elenca etichette | Elenca tutte le etichette nella cassetta postale. | 
| Etichette | Ottieni etichetta | Recupera i dettagli di un'etichetta specifica. | 
| Etichette | Crea etichetta | Crea una nuova etichetta. | 
| Etichette | Aggiorna etichetta | Aggiorna le proprietà di un'etichetta. | 
| Etichette | Etichetta e-mail | Aggiunge un'etichetta a un'e-mail. | 
| Bozze | Elenca bozze | Elenca le bozze delle email. | 
| Bozze | Ottieni bozza | Recupera una bozza specifica. | 
| Bozze | Crea bozza | Crea una nuova bozza di email. | 
| Bozze | Aggiorna bozza | Aggiorna una bozza esistente. | 
| Bozze | Invia bozza | Invia una bozza esistente. | 
| Contatti | Cerca contatti | Cerca i contatti per nome o e-mail. | 
| Contatti | Ottieni contatti | Recupera le informazioni di contatto. | 
| Cronologia | Cronologia dell'elenco | Elenca la cronologia delle modifiche delle caselle di posta. | 
| Settings | Ricevi profilo | Recupera il profilo Gmail dell'utente autenticato. | 
| Settings | Ottieni Invia come alias | Recupera una configurazione specifica di alias di invio come. | 
| Settings | Elenca Send As Alias | Elenca tutti gli alias send-as per l'account. | 

**Nota**  
Le azioni che è possibile utilizzare dipendono dai dati accessibili all'utente autenticato.

## Gestisci e risolvi i problemi
<a name="gmail-integration-troubleshooting"></a>

Per modificare, condividere o eliminare il connettore, consulta. [Gestione delle integrazioni esistenti](integration-workflows.md#managing-existing-integrations)

### Problemi comuni di autenticazione di Google
<a name="w2aac49c28c57c43b5"></a>
+ **Sign-in fallimenti (app OAuth predefinita o app OAuth personalizzata)**: verifica che il tuo account Google sia attivo e di poter accedere direttamente [al](https://accounts.google.com) 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.

### Gmail-specific problemi
<a name="gmail-troubleshooting-service"></a>
+ **API Gmail non abilitata****: verifica che l'API di Gmail sia abilitata nel tuo progetto Google Cloud in **API e servizi**, Libreria.**