Gmail
Gmail è un servizio di posta elettronica basato sul Web di Google. Con il connettore Gmail è possibile eseguire azioni come inviare o ricevere messaggi di posta elettronica e attivare i flussi sui nuovi messaggi di posta elettronica.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Servizio | Class | Regions |
|---|---|---|
| Copilot Studio | Normale | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| App per la logica | Normale | Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Normale | Tutte le aree di Power Apps , ad eccezione dei seguenti: - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Normale | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Nome | Microsoft |
| URL |
Supporto di Microsoft LogicApps Supporto di Microsoft Power Automate Supporto di Microsoft Power Apps |
| Metadati del connettore | |
|---|---|
| Editore | Microsoft |
| Sito web | https://mail.google.com/mail/ |
| Informativa sulla privacy | https://policies.google.com/privacy |
Autenticazione e bring your own application
Il connettore Gmail supporta ora più tipi di autenticazione:
- Usare l'applicazione condivisa predefinita
- Bring Your Own Application
L'applicazione condivisa predefinita usa un'applicazione Google Client gestita da Microsoft. In questo caso, quando accedi al tuo account Gmail, ti verrà chiesto di fornire il consenso all'applicazione Microsoft Power Platform .
Con l'opzione "Bring your own application" è possibile usare la propria applicazione client Google OAuth anziché quella gestita da Microsoft. In questo modo sarà possibile controllare le autorizzazioni e abilitare determinate limitazioni sull'uso del connettore.
Per usare la propria applicazione Client OAuth google con il connettore Gmail, è necessario eseguire la procedura seguente:
- Creare un'applicazione client OAuth usando la console API di Google
- Usare l'applicazione nel connettore Gmail
Creazione di un'applicazione client OAuth in Google
Per creare un'applicazione client OAuth di Google, è necessario prima accedere a https://developer.google.com. Passare a Console API di Google, dove è possibile gestire l'accesso alle API Google e creare l'applicazione OAuth. Questo processo è illustrato nella Guida per sviluppatori dell'API Gmail di Google. Google fornisce uno strumento di configurazione per guidare l'utente nel processo di creazione di un progetto, abilitare l'API Gmail per il progetto e creare un'applicazione client OAuth e le credenziali per il progetto. Ecco alcune informazioni utili quando si passa attraverso lo strumento:
- Leggere e accettare le condizioni per il servizio, se necessario.
- Selezionare un progetto esistente oppure lo strumento ne creerà uno nuovo denominato "My Project".
- Lo strumento abiliterà l'API Gmail nel progetto.
- Lo strumento tenterà di individuare il tipo di credenziale necessario. Sarà necessario ottenere un'applicazione client OAuth.
- Selezionare l'API Gmail per l'API che verrà usata (se non è già selezionata).
- Selezionare Server Web per l'oggetto da cui si chiamerà l'API.
- Selezionare Dati utente per i dati a cui si accederà.
- Lo strumento illustra la schermata di configurazione di un consenso OAuth.
- Selezionare il tipo di utente (interno o esterno). Se usi un account consumer Gmail, non puoi selezionare Interno.
- Specificare un nome e, facoltativamente, un logo per l'applicazione.
- Fare clic su Aggiungi ambito e aggiungere l'ambito Gmail (https://mail.google.com).
Annotazioni
In base alle esigenze di utilizzo, è possibile selezionare un subset appropriato degli ambiti di autorizzazione qui.
- Aggiungere azure-apim.net come uno dei domini autorizzati.
Annotazioni
Questo è il dominio in cui è ospitato il connettore Gmail, come definito qui.
- Facoltativamente, specificare le altre informazioni.
- Lo strumento consentirà di definire e aggiungere credenziali client OAuth 2.0.
- Specificare un nome per l'applicazione client OAuth.
- Aggiungi "https://global.consent.azure-apim.net/redirect" per l'URI di reindirizzamento.
Al termine, passare al client OAuth creato dalla pagina Credenziali. Troverai l'ID client e il segreto client dell'app. È ora possibile usare questi valori nella connessione Gmail.
Uso di un'applicazione personalizzata nel connettore Gmail
Dopo aver creato l'applicazione client OAuth di Google, è possibile usarla durante la creazione di una connessione Gmail.
- Selezionare Bring your own application (Bring your own application).
- Specificare i valori id client e segreto client dell'applicazione.
Fare clic su Accedi per accedere al proprio account Gmail. Verrà richiesto di accedere al proprio account Gmail e quindi autorizzare l'accesso all'app Google creata in precedenza.
Problemi noti e limitazioni
Limitazioni dei trigger per un numero elevato di messaggi di posta elettronica in arrivo
Il trigger Quando arriva un nuovo messaggio di posta elettronica può ignorare i messaggi di posta elettronica se si ricevono più di 300 messaggi di posta elettronica per intervallo di 30 secondi. Valutare la possibilità di configurare il flusso con parametri di filtro aggiuntivi per ridurre il numero di messaggi di posta elettronica.
Il trigger Quando arriva un nuovo messaggio di posta elettronica può ignorare in modo intermittente i messaggi di posta elettronica con allegati se si usa un account Google Workspace (in precedenza G Suite). Ciò accade perché in alcuni casi l'API Gmail richiede molto tempo per elaborare i messaggi di posta elettronica (probabilmente a causa delle analisi di sicurezza degli allegati), quindi i messaggi di posta elettronica vengono ricevuti con un determinato ritardo.
Come possibile soluzione alternativa, provare a eseguire le operazioni seguenti:
Usare piccoli messaggi di posta elettronica (senza allegati), provare a inviarli non così frequentemente
Usa un altro account Gmail consumer e configura l'inoltro automatico dall'account Google Workspace a questo nuovo account Gmail consumer. Configurare il trigger per questo nuovo account. Poiché si tratta di un account consumer, riteniamo che il ritardo verrà ridotto al minimo e il trigger non ignorerà tali messaggi di posta elettronica.
Usare un connettore personalizzato per l'API ListMessage con un
qparametro:Creare un'azione per elencare i messaggi degli ultimi 5 minuti. A tale scopo, è possibile usare
qil parametro . Esempio diqvalore param -after:1649457986. È necessario specificarecurrent time - 5minl'ora dell'epoca come input dell'azione.- 1649457986 è il periodo che rappresenta "Venerdì, Aprile 8, 2022 3:46:26 GMT-07:00".
Controllare il valore nextPageToken dalla risposta fino a quando non è vuoto. Se non è vuoto, è necessario chiamare la stessa API con
pageTokenil valore del parametro impostato su nextPageToken dalla risposta. È possibile farlo usando ad esempio il ciclo "Until".Filtrare gli ID dei messaggi che sono già stati elaborati nelle esecuzioni precedenti (ad esempio, è possibile usare il connettore archiviazione tabelle di Azure per archiviare gli ID già elaborati)
Usare l'azione Recupera dettagli messaggio di posta elettronica per ottenere il contenuto della posta elettronica in base all'ID
Uso del connettore Gmail con account Gmail consumer
In conformità con l'informativa sulla sicurezza e la privacy di Google, i clienti usano account Gmail consumer (account che terminano @gmail.com e @googlemail.com) possono connettersi solo a un set limitato di servizi all'interno di Power Automate e App per la logica. I clienti che usano account Google Workspace (in precedenza G Suite) non sono interessati da questa modifica. Se è necessario usare il connettore Gmail con i servizi non specificati nell'elenco seguente, è necessario registrare il proprio ID applicazione con Google. Di seguito è riportato l'elenco dei servizi approvati correnti, tenere presente che questo elenco è soggetto a modifiche in futuro in conformità alle politiche di Google:
- Servizi Google: Gmail, Google Calendar, Google Contacts, Google Drive, Google Sheets, Google Tasks
- Azioni e trigger predefiniti: Controllo, AI Builder, Operazioni dati, Data ora, Funzioni numeri, Power Virtual Agents, Power Apps, Request, Schedule, Text Functions, Variables, Flow button, Location
- Set limitato di servizi Microsoft: OneDrive, Sharepoint, Excel, Dynamics, Microsoft Teams, Office 365, SQL, SFTP e FTP
In Power Automate se si crea un flusso con un servizio non conforme, il flusso finisce per essere salvato in uno stato disabilitato.
Calcolo delle unità di lavoro
Il connettore ha un limite di limitazione (vedere qui) sul numero di unità di lavoro che possono essere utilizzate in un giorno.
La logica su come vengono calcolate queste unità di lavoro per ogni operazione è illustrata di seguito:
-
Quando arriva un nuovo messaggio di posta elettronica : 10 + (5 * attachmentsCount);
- Se trigger restituisce un nuovo messaggio di posta elettronica: 5 unità per elencare i messaggi + 5 unità per ottenere il messaggio + 5 unità * numero di allegati.
- Se il trigger non restituisce un nuovo messaggio di posta elettronica: 5 unità per elencare i messaggi.
- Azione Invia messaggio di posta elettronica (V2): 100 unità.
-
Azione Rispondi alla posta elettronica (V2): 105 + (5 * allegatiCount);
- 5 unità per ottenere il messaggio originale + 100 unità per inviare un messaggio di risposta + 5 unità * numero di allegati inline nel messaggio originale.
- Per tutte le altre azioni: 10 unità.
Approfondimento del connettore
Per altre informazioni sul connettore, vedere la sezione dettagliata.
Limiti generali
| Nome | Value |
|---|---|
| Dimensioni massime della posta (in MB) | 35 |
| Dimensioni massime degli allegati (in MB) | 30 |
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Bring Your Own Application | Accedere con la propria app Google. Per altri dettagli, vedere https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application. | Tutte le aree geografiche | Non condivisibile |
| Usare l'applicazione condivisa predefinita | Accedere con l'app Google standard. | Tutte le aree geografiche | Non condivisibile |
| Impostazione predefinita [DEPRECATO] | Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti. | Tutte le aree geografiche | Non condivisibile |
Bring Your Own Application
ID autenticazione: byoa
Applicabile: tutte le aree
Accedere con la propria app Google. Per altri dettagli, vedere https://docs.microsoft.com/connectors/gmail/#authentication-and-bring-your-own-application.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
| Nome | TIPO | Description | Obbligatorio |
|---|---|---|---|
| ID cliente | corda | ID client (o applicazione) dell'applicazione Google | Vero |
| Segreto del cliente | securestring | Segreto client dell'applicazione Google | Vero |
Usare l'applicazione condivisa predefinita
ID autenticazione: shared-application
Applicabile: tutte le aree
Accedere con l'app Google standard.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
Impostazione predefinita [DEPRECATO]
Applicabile: tutte le aree
Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
Limiti per la limitazione delle richieste
| Nome | Chiamate | Periodo di rinnovo |
|---|---|---|
| Chiamate API per connessione | 60 | 60 secondi |
| Unità di lavoro al giorno | 90000 | 86400 secondi |
Azioni
| Eliminare il messaggio di posta elettronica |
Questa operazione viene usata per eliminare definitivamente un messaggio di posta elettronica specifico. |
| Invia messaggio di posta elettronica [DEPRECATO] |
Questa azione è stata deprecata. Usare invece Invia messaggio di posta elettronica (V2).
|
| Inviare un messaggio di posta elettronica (V2) |
Questa operazione viene usata per inviare un messaggio di posta elettronica a destinatari specifici. |
| Ottenere i dettagli del messaggio di posta elettronica |
Questa operazione recupera i dettagli di un messaggio di posta elettronica specifico. |
| Rispondere al messaggio di posta elettronica (V2) |
Questa operazione viene usata per rispondere a un messaggio di posta elettronica specifico. |
| Rispondi al messaggio di posta elettronica [DEPRECATO] |
Questa azione è stata deprecata. Usare invece Rispondi al messaggio di posta elettronica (V2).
|
| Spostare un messaggio di posta elettronica nel cestino |
Questa operazione viene usata per spostare un messaggio di posta elettronica specifico nel cestino. |
Eliminare il messaggio di posta elettronica
Questa operazione viene usata per eliminare definitivamente un messaggio di posta elettronica specifico.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID messaggio
|
id | True | string |
ID del messaggio di posta elettronica da eliminare. |
Invia messaggio di posta elettronica [DEPRECATO]
Questa azione è stata deprecata. Usare invece Invia messaggio di posta elettronica (V2).
Questa operazione viene usata per inviare un messaggio di posta elettronica a destinatari specifici.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Per
|
To | True |
Elenco di indirizzi di posta elettronica validi separati da un punto e virgola o da una virgola. |
|
|
CC
|
Cc |
Elenco di indirizzi di posta elettronica validi separati da un punto e virgola o da una virgola. |
||
|
CCN
|
Bcc |
Elenco di indirizzi di posta elettronica validi separati da un punto e virgola o da una virgola. |
||
|
Oggetto
|
Subject | string |
Oggetto del messaggio di posta elettronica in uscita. |
|
|
Corpo
|
Body | string |
Corpo del messaggio di posta elettronica in uscita. |
|
|
Is HTML
|
IsHtml | boolean |
True per inviare il messaggio di posta elettronica come HTML. (impostazione predefinita: True) |
|
|
Importanza
|
Importance | string |
Importanza associata al messaggio di posta elettronica. |
|
|
Nome
|
Name | True | string |
Titolo dell'allegato. |
|
Content
|
ContentBytes | True | byte |
Corpo dell'allegato. |
|
Content-Type
|
ContentType | string |
Tipo di contenuto nell'allegato. |
Inviare un messaggio di posta elettronica (V2)
Questa operazione viene usata per inviare un messaggio di posta elettronica a destinatari specifici.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Per
|
To | True |
Elenco di indirizzi di posta elettronica validi separati da un punto e virgola o da una virgola. |
|
|
CC
|
Cc |
Elenco di indirizzi di posta elettronica validi separati da un punto e virgola o da una virgola. |
||
|
CCN
|
Bcc |
Elenco di indirizzi di posta elettronica validi separati da un punto e virgola o da una virgola. |
||
|
Oggetto
|
Subject | string |
Oggetto del messaggio di posta elettronica in uscita. |
|
|
Corpo
|
Body | html |
Corpo del messaggio di posta elettronica in uscita. |
|
|
Importanza
|
Importance | string |
Importanza associata al messaggio di posta elettronica. |
|
|
Nome
|
Name | True | string |
Titolo dell'allegato. |
|
Content
|
ContentBytes | True | byte |
Corpo dell'allegato. |
|
Content-Type
|
ContentType | string |
Tipo di contenuto nell'allegato. |
Ottenere i dettagli del messaggio di posta elettronica
Questa operazione recupera i dettagli di un messaggio di posta elettronica specifico.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID messaggio
|
id | True | string |
ID univoco del messaggio di posta elettronica. |
|
Includi allegati
|
includeAttachments | boolean |
Se impostato su true, anche gli allegati verranno recuperati insieme al messaggio di posta elettronica. |
Restituisce
Dettagli associati a un messaggio di posta elettronica specifico.
- Corpo
- DetailedReceiveMessage
Rispondere al messaggio di posta elettronica (V2)
Questa operazione viene usata per rispondere a un messaggio di posta elettronica specifico.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID messaggio
|
id | True | string |
ID del messaggio di posta elettronica a cui rispondere. |
|
Per
|
To |
Esempio: recipient1@domain.com; recipient2@domain.com |
||
|
CC
|
Cc |
Esempio: recipient1@domain.com; recipient2@domain.com |
||
|
CCN
|
Bcc |
Esempio: recipient1@domain.com; recipient2@domain.com |
||
|
Oggetto
|
Subject | string |
Oggetto del messaggio di posta elettronica (se vuoto, oggetto originale usato). |
|
|
Corpo
|
Body | html |
Contenuto dell'e-mail. |
|
|
Rispondi a tutti
|
ReplyAll | boolean |
True per rispondere a tutti i destinatari. (impostazione predefinita: False) |
|
|
Importanza
|
Importance | string |
Scegli un'importanza. (impostazione predefinita: Normale) |
|
|
Nome
|
Name | True | string |
Titolo dell'allegato. |
|
Content
|
ContentBytes | True | byte |
Corpo dell'allegato. |
|
Content-Type
|
ContentType | string |
Tipo di contenuto nell'allegato. |
Rispondi al messaggio di posta elettronica [DEPRECATO]
Questa azione è stata deprecata. Usare invece Rispondi al messaggio di posta elettronica (V2).
Questa operazione viene usata per rispondere a un messaggio di posta elettronica specifico.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID messaggio
|
id | True | string |
ID del messaggio di posta elettronica a cui rispondere. |
|
Per
|
To |
Esempio: recipient1@domain.com; recipient2@domain.com |
||
|
CC
|
Cc |
Esempio: recipient1@domain.com; recipient2@domain.com |
||
|
CCN
|
Bcc |
Esempio: recipient1@domain.com; recipient2@domain.com |
||
|
Oggetto
|
Subject | string |
Oggetto del messaggio di posta elettronica (se vuoto, oggetto originale usato). |
|
|
Corpo
|
Body | string |
Contenuto dell'e-mail. |
|
|
Rispondi a tutti
|
ReplyAll | boolean |
True per rispondere a tutti i destinatari. (impostazione predefinita: False) |
|
|
Is HTML
|
IsHtml | boolean |
True per inviare la risposta come HTML. (impostazione predefinita: True) |
|
|
Importanza
|
Importance | string |
Scegli un'importanza. (impostazione predefinita: Normale) |
|
|
Nome
|
Name | True | string |
Titolo dell'allegato. |
|
Content
|
ContentBytes | True | byte |
Corpo dell'allegato. |
|
Content-Type
|
ContentType | string |
Tipo di contenuto nell'allegato. |
Spostare un messaggio di posta elettronica nel cestino
Questa operazione viene usata per spostare un messaggio di posta elettronica specifico nel cestino.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
ID messaggio
|
id | True | string |
ID del messaggio di posta elettronica da spostare nel cestino. |
Trigger
| Quando arriva un nuovo messaggio di posta elettronica |
Questa operazione viene attivata quando arriva un nuovo messaggio di posta elettronica corrispondente ai criteri specificati. |
Quando arriva un nuovo messaggio di posta elettronica
Questa operazione viene attivata quando arriva un nuovo messaggio di posta elettronica corrispondente ai criteri specificati.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Etichetta
|
label | string |
Selezionare un'etichetta (impostazione predefinita: Posta in arrivo). |
|
|
Per
|
to |
Elenco di indirizzi di posta elettronica validi separati da un punto e virgola o da una virgola. |
||
|
Da
|
from |
Esempio: Sender1 | sender2@domain.com. |
||
|
Oggetto
|
subject | string |
Stringa da cercare nell'oggetto. |
|
|
Importanza
|
importance | string |
True se il messaggio di posta elettronica deve essere importante. (impostazione predefinita: Tutti). |
|
|
Recitato
|
starred | string |
True se il messaggio di posta elettronica deve essere visualizzato. (impostazione predefinita: Tutti). |
|
|
Presenta allegati
|
fetchOnlyWithAttachments | boolean |
True per recuperare solo i messaggi di posta elettronica con allegati. |
|
|
Includi allegati
|
includeAttachments | boolean |
True per recuperare gli allegati insieme al messaggio di posta elettronica. |
Restituisce
Dettagli associati a un messaggio di posta elettronica specifico.
- Corpo
- DetailedReceiveMessage
Definizioni
DetailedReceiveMessage
Dettagli associati a un messaggio di posta elettronica specifico.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Da
|
From |
Indirizzo di posta elettronica da cui è stato inviato il messaggio. |
|
|
Nome del mittente
|
SenderName | string |
Nome del mittente del messaggio di posta elettronica |
|
Per
|
To |
Indirizzo di posta elettronica a cui è stato inviato il messaggio. |
|
|
CC
|
Cc |
Indirizzi di posta elettronica contenuti nel campo CC. |
|
|
CCN
|
Bcc |
Indirizzi di posta elettronica contenuti nel campo Ccn. |
|
|
Oggetto
|
Subject | string |
Oggetto o argomento associato al messaggio di posta elettronica. |
|
Corpo
|
Body | string |
Contenuto del messaggio di posta elettronica. |
|
Frammento
|
Snippet | string |
Breve parte del testo del messaggio. |
|
ID etichetta
|
LabelIds | array of string |
Elenco di etichette associate al messaggio di posta elettronica. |
|
Date-Time ricevuti
|
DateTimeReceived | date-time |
Esempio:2017-05-03T20:08:57+00:00 |
|
Dimensioni stimate
|
EstimatedSize | integer |
Dimensioni stimate in byte del messaggio. |
|
Is Read?
|
IsRead | boolean |
True se il messaggio viene letto; false in caso contrario. |
|
Is HTML
|
IsHtml | boolean |
True se il messaggio è in formato HTML. |
|
Presenta allegati
|
HasAttachments | boolean |
True se il messaggio contiene allegati. |
|
Attachments
|
Attachments | array of Attachment |
Elenco di allegati al messaggio di posta elettronica. |
|
ID messaggio
|
Id | string |
ID non modificabile del messaggio. |
|
Thread ID
|
ThreadId | string |
ID del thread a cui appartiene il messaggio. |
Attachment
Proprietà di un allegato di posta elettronica.
| Nome | Percorso | Tipo | Descrizione |
|---|---|---|---|
|
Nome
|
Name | string |
Titolo dell'allegato. |
|
Content
|
ContentBytes | byte |
Corpo dell'allegato. |
|
Content-Type
|
ContentType | string |
Tipo di contenuto nell'allegato. |