Panoramica dell'API Gmail
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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
Di seguito è riportato un elenco dei termini comuni utilizzati nell'API Gmail:
- 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
da una risorsa messaggio.
- Thread
- Una raccolta di messaggi correlati che formano una conversazione. In un'app client di posta elettronica, un thread si forma quando uno o più destinatari rispondono a un messaggio con
un proprio messaggio.
- Etichetta
Un meccanismo per organizzare messaggi e thread. Ad esempio,
l'etichetta"tasse" potrebbe essere creata e applicata a tutti i messaggi e le conversazioni
che riguardano le tasse di un utente. 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 da una
risorsa etichetta.
- 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 da una
risorsa bozza.
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-29 UTC.
[null,null,["Ultimo aggiornamento 2025-08-29 UTC."],[],[],null,["# Gmail API Overview\n\nThe Gmail API is a RESTful API that can be used to access Gmail mailboxes and\nsend mail. For most web applications the Gmail API is the best choice for\nauthorized access to a user's Gmail data and is suitable for various\napplications, such as:\n\n- Read-only mail extraction, indexing, and backup\n- Automated or programmatic message sending\n- Email account migration\n- Email organization including filtering and sorting of messages\n- Standardization of email signatures across an organization\n\nFollowing is a list of common terms used in the Gmail API:\n\n*Message*\n: An email message containing the sender, recipients, subject, and body. After a\n message has been created, a message cannot be changed. A message is represented\n by a [message resource](/workspace/gmail/api/reference/rest/v1/users.messages#Message).\n\n*Thread*\n: A collection of related messages forming a conversation. In an email client\n app, a thread is formed when one or more recipients respond to a message with\n their own message.\n\n*Label*\n\n: A mechanism for organizing messages and threads. For example,\n the label \"taxes\" might be created and applied to all messages and threads\n having to do with a user's taxes. There are two types of labels:\n\n *System labels*\n : Internally-created labels, such as `INBOX`, `TRASH`, or `SPAM`. These labels\n cannot be deleted or modified. However, some system labels, such as `INBOX`\n can be applied to, or removed from, messages and threads.\n\n *User labels*\n : Labels created by a user. These labels can be deleted or modified by the\n user or an application. A user label is represented by a\n [label resource](/workspace/gmail/api/reference/rest/v1/users.labels).\n\n*Draft*\n\n: An unsent message. A message contained within the draft can be replaced.\n Sending a draft automatically deletes the draft and creates a message with\n the `SENT` system label. A draft is represented by a\n [draft resource](/workspace/gmail/api/reference/rest/v1/users.drafts).\n\nNext steps\n----------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer\n to [Get started as a Google Workspace developer](/workspace/guides/getstarted-overview).\n\n- To learn how to configure and run a simple Gmail API app, read the\n [Quickstarts overview](/workspace/gmail/api/guides/quickstarts-overview)."]]
