Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Hai 5 minuti?
Aiutaci a migliorare la documentazione di Google Workspace partecipando a un breve sondaggio online.
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 filtraggio 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.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-03 UTC."],[],[],null,["|-------------------------------------------------------------------------------------------------------------------------------------------|\n| Got 5 minutes? Help us improve our Google Workspace documentation by taking a quick [online survey](https://forms.gle/XcqRP3PJiQv9ADuj9). |\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- 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)."]]
