Dự án tập lệnh

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 được gọi đơn giản là "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 (đuôi .html). Bạn cũng có thể đưa JavaScript và CSS vào tệp HTML.

Trình soạn thảo tập lệnh luôn có 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ổ hoặc thẻ trình duyệt.

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 liên kết với vùng chứa.

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

Cách tạo dự án độc lập từ 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 Untitled project (Dự án chưa có tên).
  4. Đặt tên cho dự án rồi nhấp vào Đổi tên.

Tạo 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 trên 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 Untitled project (Dự án chưa có tên).
  4. Đặt tên cho dự án rồi nhấp vào Đổi tên.

Tạo dự án liên kết với 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.

Hãy xem Hướng dẫn về Giao diện dòng lệnh bằng clasp để biết thêm thông tin chi tiết.

Xoá dự án liên kết với vùng chứa

  1. Mở dự án liên kết với vùng chứa bằng 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 clasp, hãy tham khảo phần 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 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 rõ ràng múi giờ trong hàm. 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 là 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 múi giờ Thái Bình Dương, bất kể múi giờ của dự án là gì.

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 đăng nhập vào 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, thì bạn có thể gặp sự cố khi truy cập các tiện ích bổ sung và ứng dụng web. 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 khi đã đăng nhập vào nhiều tài khoản, 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 vấn đề khi đă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ở một 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.