Puoi utilizzare le etichette per taggare, organizzare e classificare messaggi e thread in Gmail. Un'etichetta ha una relazione many-to-many con messaggi e thread: puoi applicare più etichette a un singolo messaggio o thread e applicare una singola etichetta a più messaggi o thread.
Per informazioni su come creare, ottenere, elencare, aggiornare o eliminare le etichette, consulta le Informazioni di riferimento sulle etichette.
Per gestire le etichette, devi utilizzare l'ambito https://www.googleapis.com/auth/gmail.labels. Per saperne di più sugli ambiti, vedi Informazioni su autorizzazione e autenticazione specifiche per l'API Gmail.
Tipi di etichette
Esistono due tipi di etichette: etichette riservate SYSTEM ed etichette personalizzate USER. Le etichette di sistema in genere corrispondono a elementi predefiniti nell'interfaccia web di Gmail, ad esempio 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. La tabella seguente elenca 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 | Applicata 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 | Applicata automaticamente a tutti i messaggi draft creati con l'API Gmail o l'interfaccia Gmail. |
CATEGORY_PERSONAL | sì | Corrisponde ai messaggi visualizzati nella scheda Personale dell'interfaccia Gmail. |
CATEGORY_SOCIAL | sì | Corrisponde ai messaggi visualizzati nella scheda Social dell'interfaccia Gmail. |
CATEGORY_PROMOTIONS | sì | Corrisponde ai messaggi visualizzati nella scheda Promozioni dell'interfaccia Gmail. |
CATEGORY_UPDATES | sì | Corrisponde ai messaggi visualizzati nella scheda Aggiornamenti dell'interfaccia Gmail. |
CATEGORY_FORUMS | sì | Corrisponde ai messaggi visualizzati nella scheda Forum dell'interfaccia Gmail. |
Gestire le etichette su messaggi e thread
Le etichette esistono solo sui messaggi. Ad esempio, se elenchi le etichette in un thread, riceverai un elenco delle etichette presenti in uno qualsiasi dei messaggi all'interno del thread. Un'etichetta potrebbe non essere presente in tutti i messaggi di un thread. Puoi applicare più etichette ai messaggi, ma non puoi applicarle ai messaggi in bozza.
Aggiungere o rimuovere etichette dai thread
Quando aggiungi o rimuovi un'etichetta da una discussione, aggiungi o rimuovi l'etichetta specificata in tutti i messaggi esistenti nella discussione.
Se vengono aggiunti messaggi a una conversazione dopo l'aggiunta di un'etichetta, i nuovi messaggi non ereditano l'etichetta esistente associata alla conversazione. Per aggiungere l'etichetta a questi messaggi, aggiungila di nuovo al thread.
Per aggiungere o rimuovere le etichette associate a un thread, utilizza threads.modify.
Aggiungere o rimuovere etichette dai messaggi
Quando aggiungi un'etichetta a un messaggio, questa viene aggiunta al messaggio e viene associata al thread a cui appartiene il messaggio. L'etichetta non viene aggiunta ad altri messaggi all'interno del thread.
Se rimuovi un'etichetta da un messaggio e questo 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.