Class GmailLabel

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

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

Parametri

Invio

GmailLabel: questa etichetta, per il collegamento.

Autorizzazione

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

• https://mail.google.com/

Vedi anche

• removeFromThread(thread)

Aggiunge questa etichetta ai thread specificati e ne forza l'aggiornamento. Puoi aggiungere etichette per e possono contenere fino a 100 thread per batch.

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

Parametri

Invio

GmailLabel: questa etichetta, per il collegamento.

Autorizzazione

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

• https://mail.google.com/

Vedi anche

• removeFromThreads(threads)

Elimina questa etichetta.

var label = GmailApp.getUserLabelByName("MyLabel");
label.deleteLabel();

Lanci

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 oppure ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Vedi anche

• getName()

Recupera il nome di questa etichetta.

var label = GmailApp.getUserLabelByName("MyLabel");
Logger.log(label.getName()); //logs MyLabel

Invio

String: il nome dell'etichetta.

Autorizzazione

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

• https://mail.google.com/

Restituisce i thread contrassegnati con questa etichetta.

Questa chiamata non riesce quando la dimensione di tutti i thread è troppo grande per essere gestita dal sistema. Dove la dimensione del thread è sconosciuta e potenzialmente molto grande. Usa getThreads(start, max) e specifica gli intervalli di thread da recuperare in ogni chiamata.

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

Invio

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 oppure ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Recupera un intervallo di thread contrassegnati con questa etichetta.

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

Parametri

Invio

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 oppure ambiti appropriati dell'API REST correlata:

• https://mail.google.com/

Restituisce il numero di thread da leggere taggati con questa etichetta.

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

Invio

Integer: il numero di thread etichettati da leggere.

Autorizzazione

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

• https://mail.google.com/

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

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

Parametri

Invio

GmailLabel: questa etichetta, per il collegamento.

Autorizzazione

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

• https://mail.google.com/

Vedi anche

• addToThread(thread)

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

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

Parametri

Invio

GmailLabel: questa etichetta, per il collegamento.

Autorizzazione

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

• https://mail.google.com/

Vedi anche

• addToThreads(threads)