Puoi utilizzare le etichette per taggare, organizzare e classificare messaggi e thread in Gmail. Un'etichetta ha una relazione many-to-many con i messaggi e i thread: puoi applicare più etichette a un singolo messaggio o thread e una singola etichetta a più messaggi o thread.
Per informazioni su come create, ottenere, elencare, aggiornare, o eliminare le etichette, consulta la documentazione di riferimento sulle etichette.
Per gestire le etichette, devi utilizzare l'ambito
https://www.googleapis.com/auth/gmail.labels. Per ulteriori informazioni sugli ambiti, consulta Informazioni su autorizzazione e autenticazione specifiche per l'API Gmail.
Tipi di etichette
Esistono due tipi di etichette: SYSTEM riservate e USER personalizzate.
Le etichette di sistema in genere corrispondono a elementi predefiniti nell'interfaccia web di Gmail, come la posta in arrivo. I nomi delle etichette di sistema sono riservati. Non è possibile creare un'etichetta USER con lo stesso nome di un'etichetta SYSTEM. Nella tabella seguente sono elencate alcune delle etichette di sistema di Gmail più comuni:
| Nome | Può essere applicato manualmente | Note |
|---|---|---|
INBOX |
sì | |
SPAM |
sì | |
TRASH |
sì | |
UNREAD |
sì | |
STARRED |
sì | |
IMPORTANT |
sì | |
SENT |
no | Viene applicato automaticamente ai messaggi inviati con
drafts.send o
messages.send, inseriti
con messages.insert
e l'email dell'utente nell'intestazione From o inviati dall'utente tramite
l'interfaccia web. |
DRAFT |
no | Applicato automaticamente a tutti
draft i messaggi creati con
l'API Gmail o l'interfaccia di Gmail. |
CATEGORY_PERSONAL |
sì | Corrisponde ai messaggi visualizzati nella scheda Personale dell'interfaccia di Gmail. |
CATEGORY_SOCIAL |
sì | Corrisponde ai messaggi visualizzati nella scheda Social dell'interfaccia di Gmail. |
CATEGORY_PROMOTIONS |
sì | Corrisponde ai messaggi visualizzati nella scheda Promozioni dell'interfaccia di Gmail. |
CATEGORY_UPDATES |
sì | Corrisponde ai messaggi visualizzati nella scheda Aggiornamenti dell'interfaccia di Gmail. |
CATEGORY_FORUMS |
sì | Corrisponde ai messaggi visualizzati nella scheda Forum dell'interfaccia di Gmail. |
Gestire le etichette su messaggi e thread
Le etichette esistono solo nei messaggi. Ad esempio, se elenchi le etichette in un thread, ricevi un elenco delle etichette esistenti in uno dei messaggi all'interno del thread. Un'etichetta potrebbe non essere presente in ogni messaggio di un thread. Puoi applicare più etichette ai messaggi, ma non alle bozze.
Aggiungere o rimuovere etichette ai thread
Quando aggiungi o rimuovi un'etichetta da un thread, l'etichetta specificata viene aggiunta o rimossa da tutti i messaggi esistenti nel thread.
Se i messaggi vengono aggiunti a un thread dopo l'aggiunta di un'etichetta, i nuovi messaggi non ereditano l'etichetta esistente associata al thread. Per aggiungere l'etichetta a questi messaggi, aggiungi di nuovo l'etichetta al thread.
Per aggiungere o rimuovere le etichette associate a un thread, utilizza
threads.modify.
Aggiungere o rimuovere etichette ai messaggi
Quando aggiungi un'etichetta a un messaggio, quest'ultima viene aggiunta al messaggio e associata al thread a cui appartiene. L'etichetta non viene aggiunta agli altri messaggi del thread.
Se rimuovi un'etichetta da un messaggio ed era l'unico messaggio nel thread con quell'etichetta, l'etichetta viene rimossa anche dal thread.
Per aggiungere o rimuovere le etichette applicate a un messaggio, utilizza
messages.modify.