Class GmailLabel

Agrega esta etiqueta a la conversación determinada y la obliga a actualizarse (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);

Parámetros

Volver

GmailLabel: Esta etiqueta, para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos o los ámbitos adecuados de la API de REST relacionada:

• https://mail.google.com/

Consulta también

• removeFromThread(thread)

Agrega esta etiqueta a los subprocesos determinados y los obliga a actualizarse. Puedes agregar etiquetas para hasta 100 subprocesos por lote.

// 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);

Parámetros

Volver

GmailLabel: Esta etiqueta, para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos o los ámbitos adecuados de la API de REST relacionada:

• https://mail.google.com/

Consulta también

• removeFromThreads(threads)

Borra esta etiqueta.

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

Arroja

Error: Si no se puede borrar la etiqueta

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos o los ámbitos adecuados de la API de REST relacionada:

• https://mail.google.com/

Consulta también

• getName()

Obtiene el nombre de esta etiqueta.

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

Volver

String: Es el nombre de la etiqueta.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos o los ámbitos adecuados de la API de REST relacionada:

• https://mail.google.com/

Obtiene los subprocesos que están marcados con esta etiqueta.

Estas llamadas fallan cuando el tamaño de todos los subprocesos es demasiado grande para que el sistema pueda controlarlos. Cuando el tamaño del subproceso es desconocido y potencialmente muy grande, usa getThreads(start, max) y especifica los rangos de los subprocesos que se recuperarán en cada llamada.

// 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());
}

Volver

GmailThread[]: Es un array de subprocesos marcados con esta etiqueta.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos o los ámbitos adecuados de la API de REST relacionada:

• https://mail.google.com/

Obtiene un rango de subprocesos marcados con esta etiqueta.

// 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());
}

Parámetros

Volver

GmailThread[]: Es un array de subprocesos marcados con esta etiqueta.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos o los ámbitos adecuados de la API de REST relacionada:

• https://mail.google.com/

Obtiene la cantidad de conversaciones no leídas etiquetadas con esta etiqueta.

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

Volver

Integer: Es la cantidad de conversaciones etiquetadas no leídas.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos o los ámbitos adecuados de la API de REST relacionada:

• https://mail.google.com/

Quita esta etiqueta del subproceso determinado y lo obliga a actualizarse.

// 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);

Parámetros

Volver

GmailLabel: Esta etiqueta, para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos o los ámbitos adecuados de la API de REST relacionada:

• https://mail.google.com/

Consulta también

• addToThread(thread)

Quita esta etiqueta de los subprocesos determinados y los obliga a actualizarse. Puedes quitar etiquetas de hasta 100 conversaciones por lote.

// 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);

Parámetros

Volver

GmailLabel: Esta etiqueta, para encadenar.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos o los ámbitos adecuados de la API de REST relacionada:

• https://mail.google.com/

Consulta también

• addToThreads(threads)