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 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 (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 chỉ mở một dự án 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 dự án Apps Script đượ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. Truy cập vào script.google.com.
  2. Nhấp vào Dự án mới.
  3. Trong trình chỉnh sửa tập lệnh, hãy nhấp vào Dự án chưa đặt 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 > Khác > Apps Script.

Tạo dự án được liên kết với vùng chứa từ Google Tài liệu, Google Trang tính hoặc Google Trang trình bày

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

Tạo dự án được 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 Biểu mẫu.
  2. Nhấp vào biểu tượng Thêm > 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 chưa đặt 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 bằng công cụ dòng lệnh clasp

clasp là một công cụ dòng lệnh giúp 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 Giao diện dòng lệnh bằng clasp để biết thêm thông tin.

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

Sau khi bạn xoá một dự án Apps Script được liên kết với vùng chứa, dự án đó sẽ không thể khôi phục.

  1. Mở dự án được liên kết với vùng chứa bằng một trong các phương pháp đã mô tả trước đó.
  2. Ở trên cùng bên trái, hãy nhấp vào Tổng quan .
  3. Ở trên cùng bên phải, hãy nhấp vào biểu tượng Xoá Remove > Xoá vĩnh viễn.

Chỉ chủ sở hữu vùng chứa mới có thể thấy các lựa chọn trong trình đơn xoá.

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

  1. Truy cập vào 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 Thêm > Xoá > Xoá.

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

Phần này mô tả cách thêm, xoá và xuất tệp trong một dự án Apps Script.

Tạo tệp

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

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

Để xuất tệp mã, hãy sao chép và dán mã từ mỗi 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

Khi bạn đặt múi giờ cho một dự án Apps Script, tập lệnh sẽ sử dụng múi giờ đó khi chạy.

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

Để sử dụng một múi giờ khác cho một hàm cụ thể, hãy nhập rõ ràng múi giờ đó vào hàm đó. Ví dụ: trong mẫu sau, mỗi hàm sẽ tạo 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 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 sự cố với 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 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 tập lệnh trong 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 sự cố 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 rồi chỉ đăng nhập vào tài khoản có tiện ích bổ sung hoặc ứng dụng web 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.