Utworzona przez użytkownika etykieta na koncie Gmail użytkownika.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
addToThread(thread) | GmailLabel | Dodaje tę etykietę do danego wątku i wymusza odświeżenie wątku (GmailThread.refresh() ). |
addToThreads(threads) | GmailLabel | Dodaje tę etykietę do podanych wątków i wymusza odświeżenie wątków. |
deleteLabel() | void | Usuwa tę etykietę. |
getName() | String | Pobiera nazwę tej etykiety. |
getThreads() | GmailThread[] | Pobiera wątki oznaczone tą etykietą. |
getThreads(start, max) | GmailThread[] | Pobiera zakres wątków oznaczonych tą etykietą. |
getUnreadCount() | Integer | Pobiera liczbę nieprzeczytanych wątków oznaczonych tą etykietą. |
removeFromThread(thread) | GmailLabel | Usuwa tę etykietę z danego wątku i wymusza odświeżenie wątku. |
removeFromThreads(threads) | GmailLabel | Usuwa tę etykietę z podanych wątków i wymusza odświeżenie wątków. |
Szczegółowa dokumentacja
addToThread(thread)
Dodaje tę etykietę do danego wątku i wymusza odświeżenie wątku (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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
thread | GmailThread | Wątek, który zostanie oznaczony etykietą. |
Powrót
GmailLabel
– etykieta na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
addToThreads(threads)
Dodaje tę etykietę do podanych wątków i wymusza odświeżenie wątków. Możesz dodać etykiety dla: do 100 wątków na grupę.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
threads | GmailThread[] | Tablica wątków do oznaczenia etykietami. |
Powrót
GmailLabel
– etykieta na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
deleteLabel()
Usuwa tę etykietę.
var label = GmailApp.getUserLabelByName("MyLabel"); label.deleteLabel();
Rzuty
Error
– jeśli etykiety nie można usunąć;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
getName()
Pobiera nazwę tej etykiety.
var label = GmailApp.getUserLabelByName("MyLabel"); Logger.log(label.getName()); //logs MyLabel
Powrót
String
– nazwa etykiety.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
getThreads()
Pobiera wątki oznaczone tą etykietą.
To wywołanie kończy się niepowodzeniem, gdy rozmiar wszystkich wątków jest zbyt duży, aby system mógł go obsłużyć. Gdzie
rozmiar wątku jest nieznany i potencjalnie bardzo duży. Użyj funkcji getThreads(start, max)
i określ zakresy wątków do pobrania w każdym wywołaniu.
// 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()); }
Powrót
GmailThread[]
– tablica wątków oznaczonych tą etykietą.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
getThreads(start, max)
Pobiera zakres wątków oznaczonych tą etykietą.
// 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()); }
Parametry
Nazwa | Typ | Opis |
---|---|---|
start | Integer | Indeks wątku początkowego. |
max | Integer | Maksymalna liczba wątków do zwrócenia. |
Powrót
GmailThread[]
– tablica wątków oznaczonych tą etykietą.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
getUnreadCount()
Pobiera liczbę nieprzeczytanych wątków oznaczonych tą etykietą.
// log the number of unread threads labeled with MyLabel var label = GmailApp.getUserLabelByName("MyLabel"); Logger.log(label.getUnreadCount());
Powrót
Integer
– liczba nieprzeczytanych wątków oznaczonych etykietą.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
removeFromThread(thread)
Usuwa tę etykietę z danego wątku i wymusza odświeżenie wątku.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
thread | GmailThread | Wątek nie będzie miał etykiety. |
Powrót
GmailLabel
– etykieta na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/
Zobacz też
removeFromThreads(threads)
Usuwa tę etykietę z podanych wątków i wymusza odświeżenie wątków. Możesz usunąć etykiety dla maksymalnie 100 wątków na grupę.
// 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);
Parametry
Nazwa | Typ | Opis |
---|---|---|
threads | GmailThread[] | Tablica wątków bez etykiety. |
Powrót
GmailLabel
– etykieta na potrzeby tworzenia łańcuchów.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów lub odpowiednimi zakresami z powiązanego interfejsu API REST:
-
https://mail.google.com/