Dự án tập lệnh

Một dự án tập lệnh đại diện cho một tập hợp các tệp và tài nguyên trong Google Apps Script, đôi khi chỉ được gọi là "một tập lệnh". Một dự án tập lệnh có một hoặc nhiều tệp tập lệnh có thể là tệp mã (có đuôi .gs) hoặc tệp HTML (có đuôi .html). Bạn cũng có thể đưa JavaScript và CSS vào tệp HTML.

Trình chỉnh sửa tập lệnh luôn mở một và chỉ một dự án được mở tại một thời điểm bất kỳ. Bạn có thể mở nhiều dự án trong nhiều cửa sổ trình duyệt hoặc thẻ.

Tạo và xoá dự án

Phần này giải thích cách tạo và xoá các dự án Apps Script độc lập hoặc ràng buộc với vùng chứa.

Tạo một dự án độc lập

Cách tạo dự án độc lập bằng Apps Script:

  1. Chuyển đến script.google.com.
  2. Nhấp vào New Project (Dự án mới).
  3. Trong trình chỉnh sửa tập lệnh, hãy nhấp vào Dự án không có tiêu đề.
  4. Đặt tên cho dự án rồi nhấp vào Đổi tên.

Tạo một dự án độc lập từ Google Drive

  1. Mở Google Drive.
  2. Nhấp vào Mới > Thêm > Google Apps Script.

Tạo một dự án ràng buộc vùng chứa từ Google Tài liệu, Trang tính hoặc Trang trình bày

  1. Mở một tài liệu trong Tài liệu, bảng tính trên Trang tính hoặc bản trình bày trên Trang trình bày.
  2. Nhấp vào Tiện ích > Google Apps Script.
  3. Trong trình chỉnh sửa tập lệnh, hãy nhấp vào Dự án không có tiêu đề.
  4. Đặt tên cho dự án rồi nhấp vào Đổi tên.

Tạo dự án ràng buộc vùng chứa từ Google Biểu mẫu

  1. Mở một biểu mẫu trong Google Biểu mẫu.
  2. Nhấp vào biểu tượng Tuỳ chọn khác > Trình chỉnh sửa tập lệnh.
  3. Trong trình chỉnh sửa tập lệnh, hãy nhấp vào Dự án không có tiêu đề.
  4. Đặt tên cho dự án rồi nhấp vào Đổi tên.

Tạo một dự án độc lập bằng công cụ dòng lệnh clasp

clasp là một công cụ dòng lệnh cho phép bạn tạo, kéo/đẩy và triển khai các dự án Apps Script từ một thiết bị đầu cuối.

Xem Hướng dẫn sử dụng Giao diện dòng lệnh bằng clasp để biết thêm thông tin chi tiết.

Xoá dự án bị ràng buộc bởi vùng chứa

  1. Mở dự án ràng buộc vùng chứa theo phương thức thích hợp ở trên.
  2. Ở trên cùng bên trái, hãy nhấp vào biểu tượng Tổng quan .
  3. Ở trên cùng bên phải, hãy nhấp vào biểu tượng Xoá > Xoá vĩnh viễn.

Xoá dự án độc lập

  1. Chuyển đến script.google.com.
  2. Ở bên phải dự án mà bạn muốn xoá, hãy nhấp vào biểu tượng Tuỳ chọn khác > Xoá > Xoá.

Quản lý tệp trong dự án

Tạo tệp

  1. Mở dự án Apps Script.
  2. Ở bên trái, hãy nhấp vào biểu tượng Trình chỉnh sửa > Thêm .
  3. Chọn loại tệp cần tạo và đặt tên cho tệp.

Xoá tệp

  1. Mở dự án Apps Script.
  2. Ở bên trái, hãy nhấp vào biểu tượng Trình chỉnh sửa .
  3. Bên cạnh tệp bạn muốn xoá, hãy nhấp vào biểu tượng Thêm > Xoá.

Xuất tệp ra khỏi dự án Apps Script

Để lấy các tệp mã ra khỏi Apps Script, bạn có thể sao chép và dán mã từ từng tệp vào trình chỉnh sửa văn bản mà bạn muốn hoặc sử dụng clasp trên dòng lệnh. Để sử dụng khoá, hãy tham khảo bài viết tải dự án tập lệnh xuống.

Đặt múi giờ cho dự án

Bạn có thể đặt múi giờ cho một dự án Apps Script. Các hàm do tập lệnh thực hiện sẽ sử dụng múi giờ này.

  1. Mở dự án Apps Script.
  2. Ở bên trái, hãy nhấp vào biểu tượng Cài đặt dự án Biểu tượng cho phần cài đặt dự án.
  3. Trong mục Múi giờ, hãy chọn múi giờ bạn muốn sử dụng.

Nếu bạn muốn một hàm cụ thể sử dụng múi giờ khác với dự án tập lệnh, hãy nhập múi giờ rõ ràng trong hàm của bạn. Ví dụ: trong mẫu dưới đây, mỗi hàm tạo ra một sự kiện mới trong Lịch Google. Hàm đầu tiên mặc định theo múi giờ của dự án. Hàm thứ hai chỉ định múi giờ Thái Bình Dương, vì vậy, sự kiện được lên lịch theo giờ Thái Bình Dương, bất kể múi giờ của dự án.

function createEvent(){
// Creates an event in the script project's time zone and logs the ID
var event = CalendarApp.getDefaultCalendar().createEvent('New test event',
   new Date('December 20, 2022 17:00:00'),
   new Date('December 20, 2022 18:00:00'));
console.log('Event ID: ' + event.getId());
}
function createEventPacific(){
// Creates an event with a specified time zone and logs the event ID.
var event = CalendarApp.getDefaultCalendar().createEvent('New sample event',
   new Date('December 20, 2022 17:00:00 PDT'),
   new Date('December 20, 2022 18:00:00 PDT'));
console.log('Event ID: ' + event.getId());
}

Khắc phục vấn đề khi có nhiều Tài khoản Google

Nếu đã đăng nhập vào nhiều Tài khoản Google cùng lúc, bạn có thể gặp sự cố khi truy cập vào các tiện ích bổ sung và ứng dụng web của mình. Tính năng đăng nhập nhiều tài khoản hay đăng nhập vào nhiều Tài khoản Google cùng lúc không được hỗ trợ đối với Apps Script, tiện ích bổ sung hoặc ứng dụng web.

  • Nếu bạn mở trình chỉnh sửa Apps Script trong khi đã đăng nhập vào nhiều tài khoản, thì Google sẽ nhắc bạn chọn tài khoản mà bạn muốn tiếp tục.

  • Nếu bạn mở một ứng dụng web hoặc tiện ích bổ sung và gặp sự cố đăng nhập nhiều tài khoản, hãy thử một trong các giải pháp sau:

    • Đăng xuất khỏi tất cả Tài khoản Google và chỉ đăng nhập vào tài khoản có ứng dụng web hoặc tiện ích bổ sung mà bạn muốn truy cập.
    • Mở cửa sổ ẩn danh trong Google Chrome hoặc một cửa sổ duyệt web ở chế độ riêng tư tương đương rồi đăng nhập vào Tài khoản Google có tiện ích bổ sung hoặc ứng dụng web mà bạn muốn truy cập.