Ta klasa umożliwia deweloperowi zapisywanie danych w dzienniku wykonania i w Google Cloud Logging, jeśli skrypt jest powiązany z standardowym projektem Cloud. Ta klasa jest preferowana w przypadku logowania uporządkowanego i obsługi json
w Cloud Logging. W przypadku rejestrowania na podstawie czasu użyj console
.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
clear() | void | Czyści dziennik. |
get | String | Zwraca pełną listę wiadomości w bieżącym dzienniku. |
log(data) | Logger | Zapisuje dane w dzienniku. |
log(format, values) | Logger | Zapisuje sformatowany ciąg znaków w konsoli rejestrowania, używając podanego formatu i wartości. |
Szczegółowa dokumentacja
clear()
Czyści dziennik.
get Log()
Zwraca pełną listę wiadomości w bieżącym dzienniku. Za pomocą tej metody możesz zapisać lub wysłać e-mailem cały dziennik utworzony podczas wykonywania skryptu.
// Generate a log, then email it to the person who ran the script. const files = DriveApp.getFiles(); while (files.hasNext()) { Logger.log(files.next().getName()); } const recipient = Session.getActiveUser().getEmail(); const subject = 'A list of files in your Google Drive'; const body = Logger.getLog(); MailApp.sendEmail(recipient, subject, body);
Powrót
String
– dziennik z konsoli rejestrowania
log(data)
Zapisywanie danych w dzienniku. Dane mogą być ciągiem znaków, obiektem JavaScriptu lub obiektem z właściwością message
.
Logger.log("my log message"); // Info my logmessage Logger.log({ key: "value" }); // Info {key=value} Logger.log({ message: "my log message", data: { key: "value" } }) // Info my logmessage
Jeśli podczas przekazywania obiektu zawiera on właściwość message
, jest ona używana jako wiadomość dziennika. W przeciwnym razie wywoływana jest metoda to
, która służy do konwertowania obiektu na ciąg znaków. Wszystkie inne właściwości, które można zserializować w formacie JSON, są uwzględniane w json
w Log
, podobnie jak w przykładzie poniżej:
{ "insertId": "w5eib...", "jsonPayload": { "message": "my log message", "serviceContext": { "service": "AKfyc..." }, "data": { "key": "value" } }, "resource": { "type": "app_script_function", "labels": { "invocation_type": "editor", "function_name": "unknown", "project_id": "1234567890" } }, "timestamp": "2024-11-15T23:28:19.448591Z", "severity": "INFO", "labels": { "script.googleapis.com/user_key": "AOX2d...", "script.googleapis.com/process_id": "EAEA1...", "script.googleapis.com/project_key": "MQXvl...", "script.googleapis.com/deployment_id": "AKfyc..." }, "logName": "projects/[PROJECT_ID]/logs/script.googleapis.com%2Fconsole_logs", "receiveTimestamp": "2024-11-15T23:28:20.363790313Z" }
Parametry
Nazwa | Typ | Opis |
---|---|---|
data | Object | obiekt do zarejestrowania. |
Powrót
Logger
– Logger, do łańcuchowania.
log(format, values)
Zapisuje sformatowany ciąg znaków w konsoli rejestrowania, używając podanego formatu i wartości. Ciąg tekstowy może zawierać wiele obiektów zastępczych %s
, które są zastępowane przez odpowiadające im wartości z listy argumentów, przekształcone w ciągi tekstowe.
// Log the number of Google Groups you belong to. const groups = GroupsApp.getGroups(); Logger.log('You are a member of %s Google Groups.', groups.length);
Parametry
Nazwa | Typ | Opis |
---|---|---|
format | String | ciąg znaków formatu zawierający tyle wystąpień argumentu %s , ile jest argumentów values ; |
values | Object... | zmienną liczbę wartości do wstawienia w ciągu formatowania; |
Powrót
Logger
– Logger, do łańcuchowania