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 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 dell'account email
  • Organizzazione delle email, inclusi il filtro e l'ordinamento dei messaggi
  • Standardizzazione delle firme delle 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 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 la elimina automaticamente e crea un messaggio con l'etichetta di sistema SENT. Una bozza è rappresentata dalla risorsa drafts. Per saperne di più, vedi Lavorare con 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 oppure 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 di poter essere utilizzato in una regola o un filtro di inoltro, un indirizzo 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 thread che riguardano le tasse di un utente. Per saperne di più, consulta Gestire le etichette.

Esistono due tipi di etichette:

Etichette del 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 risorsa labels.
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 risorsa messages.

Notifiche push

Un sistema di notifiche 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 il polling continuo del server per gli aggiornamenti. Per ulteriori informazioni, vedi 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

Un insieme 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 un proprio messaggio. Per saperne di più, consulta Gestire i thread.

  • Per informazioni sullo sviluppo con le API 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.