Class GmailLabel

GmailLabel

Un'etichetta creata dall'utente nell'account Gmail di un utente.

Metodi

Metodo	Tipo restituito	Breve descrizione
addToThread(thread)	GmailLabel	Aggiunge questa etichetta al thread specificato e forza l'aggiornamento del thread (GmailThread.refresh()).
addToThreads(threads)	GmailLabel	Aggiunge questa etichetta ai thread specificati e forza l'aggiornamento dei thread.
deleteLabel()	void	Elimina questa etichetta.
getId()	String	Recupera l'ID di questa etichetta.
getName()	String	Recupera il nome di questa etichetta.
getThreads()	GmailThread[]	Recupera i thread contrassegnati con questa etichetta.
getThreads(start, max)	GmailThread[]	Recupera un intervallo di thread contrassegnati con questa etichetta.
getUnreadCount()	Integer	Recupera il numero di thread non letti contrassegnati con questa etichetta.
removeFromThread(thread)	GmailLabel	Rimuove questa etichetta dal thread specificato e forza l'aggiornamento del thread.
removeFromThreads(threads)	GmailLabel	Rimuove questa etichetta dai thread specificati e forza l'aggiornamento dei thread.

Documentazione dettagliata

addToThread(thread)

Aggiunge questa etichetta al thread specificato e forza l'aggiornamento del thread (GmailThread.refresh()).

// label the first thread in the inbox with the label MyLabel
const label = GmailApp.getUserLabelByName('MyLabel');
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
label.addToThread(firstThread);

Parametri

Nome	Tipo	Descrizione
thread	GmailThread	Il thread a cui applicare l'etichetta.

Indietro

GmailLabel : questa etichetta, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dalla relativa API REST:

• https://mail.google.com/

Vedi anche

• removeFromThread(thread)

---

addToThreads(threads)

Aggiunge questa etichetta ai thread specificati e forza l'aggiornamento dei thread. Puoi aggiungere etichette a un massimo di 100 thread per batch.

// label the first three threads in the inbox with the label MyLabel
const label = GmailApp.getUserLabelByName('MyLabel');
const threads = GmailApp.getInboxThreads(0, 3);
label.addToThreads(threads);

Parametri

Nome	Tipo	Descrizione
threads	GmailThread[]	Un array di thread a cui applicare l'etichetta.

Indietro

GmailLabel : questa etichetta, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dalla relativa API REST:

• https://mail.google.com/

Vedi anche

• removeFromThreads(threads)

---

deleteLabel()

Elimina questa etichetta.

const label = GmailApp.getUserLabelByName('MyLabel');
label.deleteLabel();

Genera

Error : se l'etichetta non può essere eliminata

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dalla relativa API REST:

• https://mail.google.com/

Vedi anche

• getName()

---

getId()

Recupera l'ID di questa etichetta.

const label = GmailApp.getUserLabelByName('MyLabel');
console.log(label.getId());

Indietro

String : l'ID dell'etichetta.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dalla relativa API REST:

• https://mail.google.com/

---

getName()

Recupera il nome di questa etichetta.

const label = GmailApp.getUserLabelByName('MyLabel');
Logger.log(label.getName());  // logs MyLabel

Indietro

String : il nome dell'etichetta.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dalla relativa API REST:

• https://mail.google.com/

---

getThreads()

Recupera i thread contrassegnati con questa etichetta.

Queste chiamate non riescono quando la dimensione di tutti i thread è troppo grande per essere gestita dal sistema. Se la dimensione del thread è sconosciuta e potenzialmente molto grande, utilizza getThreads(start, max) e specifica gli intervalli dei thread da recuperare in ogni chiamata.

// Log the subject lines of the threads labeled with MyLabel
const label = GmailApp.getUserLabelByName('MyLabel');
const threads = label.getThreads();
for (let i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

Indietro

GmailThread[] : un array di thread contrassegnati con questa etichetta.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dalla relativa API REST:

• https://mail.google.com/

---

getThreads(start, max)

Recupera un intervallo di thread contrassegnati con questa etichetta.

// log the subject lines of up to the first 30 threads with the label MyLabel
const label = GmailApp.getUserLabelByName('MyLabel');
const threads = label.getThreads(0, 30);
for (let i = 0; i < threads.length; i++) {
  Logger.log(threads[i].getFirstMessageSubject());
}

Parametri

Nome	Tipo	Descrizione
start	Integer	L'indice del thread iniziale.
max	Integer	Il numero massimo di thread da restituire.

Indietro

GmailThread[] : un array di thread contrassegnati con questa etichetta.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dalla relativa API REST:

• https://mail.google.com/

---

getUnreadCount()

Recupera il numero di thread non letti contrassegnati con questa etichetta.

// log the number of unread threads labeled with MyLabel
const label = GmailApp.getUserLabelByName('MyLabel');
Logger.log(label.getUnreadCount());

Indietro

Integer : il numero di thread etichettati non letti.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dalla relativa API REST:

• https://mail.google.com/

---

removeFromThread(thread)

Rimuove questa etichetta dal thread specificato e forza l'aggiornamento del thread.

// remove the label MyLabel from the first thread in the inbox
const label = GmailApp.getUserLabelByName('MyLabel');
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
label.removeFromThread(firstThread);

Parametri

Nome	Tipo	Descrizione
thread	GmailThread	Il thread a cui rimuovere l'etichetta.

Indietro

GmailLabel : questa etichetta, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dalla relativa API REST:

• https://mail.google.com/

Vedi anche

• addToThread(thread)

---

removeFromThreads(threads)

Rimuove questa etichetta dai thread specificati e forza l'aggiornamento dei thread. Puoi rimuovere le etichette da un massimo di 100 thread per batch.

// remove the label MyLabel from the first three threads in the inbox
const label = GmailApp.getUserLabelByName('MyLabel');
const threads = GmailApp.getInboxThreads(0, 3);
label.removeFromThreads(threads);

Parametri

Nome	Tipo	Descrizione
threads	GmailThread[]	Un array di thread a cui rimuovere l'etichetta.

Indietro

GmailLabel : questa etichetta, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dalla relativa API REST:

• https://mail.google.com/

Vedi anche

• addToThreads(threads)