Trang này được dịch bởi Cloud Translation API.

Class Logger

Lớp này cho phép nhà phát triển ghi vào Nhật ký thực thi và Google Cloud Logging nếu tập lệnh được liên kết với một Dự án trên Google Cloud tiêu chuẩn. Bạn nên sử dụng lớp này để ghi nhật ký có cấu trúc và hỗ trợ jsonPayload trong Cloud Logging. Để ghi nhật ký dựa trên thời gian, hãy sử dụng console.

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`clear()`	`void`	Xoá nhật ký.
`getLog()`	`String`	Trả về danh sách đầy đủ các thông báo trong nhật ký hiện tại.
`log(data)`	`Logger`	Ghi dữ liệu vào nhật ký.
`log(format, values)`	`Logger`	Ghi một chuỗi được định dạng vào bảng điều khiển ghi nhật ký, sử dụng định dạng và giá trị được cung cấp.

Tài liệu chi tiết

`clear()`

Xoá nhật ký.

`getLog()`

Trả về danh sách đầy đủ các thông báo trong nhật ký hiện tại. Bạn có thể dùng phương thức này để lưu hoặc gửi email toàn bộ đầu ra nhật ký được tạo trong quá trình thực thi tập lệnh.

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

Cầu thủ trả bóng

String – nhật ký từ bảng điều khiển ghi nhật ký

`log(data)`

Ghi dữ liệu vào nhật ký. Dữ liệu có thể là một chuỗi, đối tượng JavaScript hoặc đối tượng có thuộc tính 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

Khi truyền một đối tượng, nếu đối tượng đó chứa thuộc tính message, thì thuộc tính đó sẽ được dùng làm thông điệp nhật ký. Nếu không, phương thức toString() sẽ được gọi để chuyển đổi đối tượng thành một chuỗi. Tất cả các thuộc tính khác có thể chuyển đổi tuần tự JSON đều được đưa vào jsonPayload trong LogEntry, tương tự như ví dụ bên dưới:

{
  "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"
}

Tham số

Tên	Loại	Mô tả
`data`	`Object`	đối tượng cần ghi nhật ký

Cầu thủ trả bóng

Logger – Trình ghi nhật ký, để tạo chuỗi.

`log(format, values)`

Ghi một chuỗi được định dạng vào bảng điều khiển ghi nhật ký, sử dụng định dạng và giá trị được cung cấp. Chuỗi này có thể bao gồm nhiều phần giữ chỗ %s, được thay thế bằng các giá trị tương ứng từ danh sách đối số, được chuyển đổi thành chuỗi.

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

Tham số

Tên	Loại	Mô tả
`format`	`String`	một chuỗi định dạng chứa số lượng thực thể `%s` bằng số lượng đối số `values`
`values`	`Object...`	một số lượng giá trị biến để chèn vào chuỗi định dạng

Cầu thủ trả bóng

Logger – Trình ghi nhật ký, để tạo chuỗi