Panoramica dell'API Gmail

L'API Gmail è un'API RESTful che ti consente di 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 ulteriori informazioni, vedi Gestire i delegati.
Draft
Un messaggio non inviato. Puoi sostituire il messaggio contenuto nella bozza. L'invio di una bozza la elimina automaticamente e crea un messaggio con l'etichetta di sistema SENT. La risorsa drafts rappresenta una bozza. 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 utilizzare un indirizzo in una regola di forwarding o un filtro, devi registrarlo e verificarlo per dimostrarne la proprietà. Per saperne di più, consulta Gestire l'inoltro.
Etichetta

Un meccanismo per organizzare messaggi e thread. Ad esempio, puoi creare l'etichetta "tasse" e applicarla a tutti i messaggi e i thread correlati alle tasse. Per saperne di più, consulta Gestire le etichette.

Esistono due tipi di etichette:

Etichette del sistema
Etichette create internamente, ad esempio INBOX, TRASH o SPAM. Non puoi eliminare o modificare queste etichette. Tuttavia, puoi applicare o rimuovere alcune etichette di sistema, ad esempio INBOX, a o da messaggi e thread.
Etichette utente
Etichette create da un utente. Un utente o un'applicazione può eliminare o modificare queste etichette. La risorsa labels rappresenta un'etichetta utente.
Messaggio

Un messaggio email contenente il mittente, i destinatari, l'oggetto e il corpo. Dopo aver creato un messaggio, non puoi modificarlo. La risorsa messages rappresenta un messaggio.

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 invia webhook o avvisi automatici ogni volta che si verifica una modifica (ad esempio l'arrivo di una nuova email). In questo modo, la tua app non deve eseguire il polling del server per gli aggiornamenti. Per ulteriori informazioni, vedi Notifiche push.

Certificati S/MIME

Certificati digitali caricati su alias Invia come specifici. Questi certificati ti consentono di inviare email criptate e firmate digitalmente, garantendo la sicurezza dei messaggi e l'autenticità del mittente. Per saperne di più, vedi 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 client di posta elettronica, 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 Google Workspace, inclusa la gestione dell'autenticazione e dell'autorizzazione, consulta la sezione Sviluppare su Google Workspace.

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