Panoramica dell'API Gmail

L'API Gmail è un'API RESTful che può essere utilizzata per accedere alle caselle di posta di Gmail e inviare email. Per la maggior parte delle applicazioni web, l'API Gmail è la scelta migliore per l'accesso autorizzato ai dati di Gmail di un utente ed è adatta a varie applicazioni, ad esempio:

  • Estrazione, indicizzazione e backup della posta in sola lettura
  • Invio di messaggi automatici o programmatici
  • Migrazione account email
  • Organizzazione delle email, inclusi il filtro e l'ordinamento dei messaggi
  • Standardizzazione delle firme email in un'organizzazione

Termini comuni

Di seguito è riportato un elenco di termini comuni utilizzati in questa API:

Delegante e delegato
Un delegante è un utente di Gmail che concede l'accesso alla casella di posta a un altro utente all'interno della stessa organizzazione Google Workspace. L'utente che riceve questo accesso è il delegato. I delegati possono leggere, inviare ed eliminare messaggi, nonché visualizzare e aggiungere contatti per conto dell'account del delegante. Per saperne di più, consulta Gestire i delegati.
Draft
Un messaggio non inviato. Un messaggio contenuto nella bozza può essere sostituito. L'invio di una bozza elimina automaticamente la bozza e crea un messaggio con l'etichetta di sistema SENT. Una bozza è rappresentata dalla drafts risorsa. Per saperne di più, consulta Utilizzare le bozze.
Filtri
Regole avanzate configurate per un account che valutano i messaggi in arrivo in base a criteri di corrispondenza specifici (come mittente, oggetto o dimensione). Quando un messaggio corrisponde, i filtri attivano automaticamente azioni come l'aggiunta o la rimozione di etichette o l'inoltro dell'email a un indirizzo specificato. Per saperne di più, consulta Gestire i filtri.
Indirizzi di inoltro
Indirizzi email specifici e verificati configurati per ricevere messaggi inoltrati automaticamente dall'account di un utente. Prima che un indirizzo possa essere utilizzato in una regola di forwarding o in un filtro, deve essere registrato e verificato ufficialmente per dimostrare la proprietà. Per saperne di più, consulta Gestire l'inoltro.
Etichetta

Un meccanismo per organizzare messaggi e thread. Ad esempio, l'etichetta "tasse" potrebbe essere creata e applicata a tutti i messaggi e i thread relativi alle tasse di un utente. Per saperne di più, consulta Gestire le etichette.

Esistono due tipi di etichette:

Etichette di sistema
Etichette create internamente, come INBOX, TRASH o SPAM. Queste etichette non possono essere eliminate o modificate. Tuttavia, alcune etichette di sistema, come INBOX, possono essere applicate o rimosse da messaggi e thread.
Etichette utente
Etichette create da un utente. Queste etichette possono essere eliminate o modificate dall'utente o da un'applicazione. Un'etichetta utente è rappresentata dalla labels risorsa.
Messaggio

Un messaggio email contenente il mittente, i destinatari, l'oggetto e il corpo. Una volta creato, un messaggio non può essere modificato. Un messaggio è rappresentato dalla messages risorsa.

Notifiche push

Un sistema di notifica lato server che si integra con Google Cloud Pub/Sub. Le applicazioni possono "monitorare" una casella di posta e l'API Gmail invierà webhook o avvisi automatici ogni volta che si verifica una modifica (ad esempio l'arrivo di una nuova email), eliminando la necessità per l'app di eseguire continuamente il polling del server per gli aggiornamenti. Per saperne di più, consulta Notifiche push.

Certificati S/MIME

Certificati digitali caricati su alias Invia come specifici che consentono a un utente di inviare email criptate e con firma digitale, garantendo la sicurezza dei messaggi e l'autenticità del mittente. Per saperne di più, consulta Gestire i certificati S/MIME.

Alias Invia come

Questi rappresentano i vari indirizzi email da cui un account è autorizzato a inviare posta. Ogni account ha almeno un alias che rappresenta l'indirizzo email principale. Gli alias corrispondono alla funzionalità "Invia posta come" nell'interfaccia web di Gmail e sono anche la base per la configurazione delle firme email per indirizzo. Per saperne di più, consulta Gestire gli alias.

Thread

Una raccolta di messaggi correlati che formano una conversazione. In un'app client di posta, un thread si forma quando uno o più destinatari rispondono a un messaggio con il proprio messaggio. Per saperne di più, consulta Gestire i thread.

  • Per scoprire di più sullo sviluppo con le API di Google Workspace, inclusa la gestione dell'autenticazione e dell'autorizzazione, consulta Sviluppare su Google Workspace.

  • Per scoprire come configurare ed eseguire un'app API Gmail, leggi le guide rapide.