Questo documento spiega come gestire le etichette su thread e messaggi utilizzando l'API Gmail.
Puoi utilizzare le etichette per taggare, organizzare e categorizzare 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
la risorsa labels.
Per gestire le etichette, devi utilizzare
l'ambito non sensibile https://www.googleapis.com/auth/gmail.labels. Per maggiori
informazioni sugli ambiti, vedi Scegliere gli ambiti
dell'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 INBOX. I nomi delle etichette di sistema sono
riservati; non è possibile creare un'etichetta USER con lo stesso nome di un'etichetta SYSTEM. La seguente tabella 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 | Applicate automaticamente ai messaggi che:
|
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 thread e messaggi
Le etichette esistono solo sui messaggi. Se recuperi un elenco di etichette in un thread, ottieni un elenco di etichette presenti in qualsiasi messaggio all'interno del thread. Un'etichetta potrebbe non esistere in ogni messaggio all'interno di un thread.
Non puoi applicare etichette alle bozze di messaggi.
Aggiungere o rimuovere etichette dai thread
Quando aggiungi o rimuovi un'etichetta in un thread, aggiungi o rimuovi l'etichetta specificata in tutti i messaggi esistenti nel thread.
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.