Puoi utilizzare le etichette per taggare, organizzare e classificare messaggi e thread in Gmail. Un'etichetta ha una relazione molti a molti con messaggi e thread: puoi applicare più etichette a un singolo messaggio o thread e una singola etichetta a più messaggi o thread.
Per informazioni su come creare, ottenere, list, 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 le informazioni su autorizzazione e autenticazione specifiche per l'API Gmail.
Tipi di etichette
Le etichette sono disponibili in due tipi: etichette SYSTEM riservate e etichette USER personalizzate.
Le etichette del 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 etichette USER con lo stesso nome di qualsiasi etichetta SYSTEM. Nella seguente tabella sono elencate diverse delle etichette di sistema Gmail più comuni:
| Nome | Applicabili 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 all'email dell'utente nell'intestazione From o inviati dall'utente tramite
l'interfaccia web. |
DRAFT |
no | Applicato automaticamente a tutti i messaggi
draft 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, riceverai un elenco delle etichette esistenti in uno qualsiasi dei messaggi all'interno del thread. Potrebbe non esistere un'etichetta in ogni messaggio all'interno di un thread. Puoi applicare più etichette ai messaggi, ma non puoi applicare etichette alle bozze dei messaggi.
Aggiungere o rimuovere le etichette ai thread
Quando aggiungi o rimuovi un'etichetta a un thread, aggiungi o rimuovi l'etichetta specificata in 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 ai 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, l'etichetta viene aggiunta al messaggio e diventa 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 che era l'unico messaggio del thread con quell'etichetta, l'etichetta viene rimossa anche dal thread.
Per aggiungere o rimuovere le etichette applicate a un messaggio, utilizza messages.modify.