Cấu trúc tệp kê khai

Trang này mô tả cấp cao nhất của cấu trúc dữ liệu JSON trong tệp kê khai của dự án Apps Script.

Các cấu trúc phụ của tệp kê khai được xác định trong các trang riêng biệt:

Tệp kê khai

Cấp cao nhất của cấu hình tệp kê khai.

Biểu diễn dưới dạng JSON
{
  "addOns": {
    object (AddOns)
  },
  "chat": {},
  "dependencies": {
    object (Dependencies)
  },
  "exceptionLogging": string,
  "executionApi": {
    object (ExecutionApi)
  },
  "oauthScopes": [
    string
  ],
  "runtimeVersion": string,
  "sheets": {
    object (Sheets)
  },
  "timeZone": string,
  "urlFetchWhitelist": [
    string
  ],
  "webapp": {
    object (Webapp)
  }
}
Trường
addOns

object (AddOns)

Cấu hình tài nguyên của dự án nếu được triển khai dưới dạng Tiện ích bổ sung của Google Workspace.

chat

object

Cấu hình của dự án nếu được triển khai dưới dạng ứng dụng Google Chat. Để định cấu hình thông tin chi tiết của ứng dụng Chat, bạn phải bật API Google Chat. Để biết thông tin chi tiết, hãy xem phần Định cấu hình API Google Chat.

Apps Script xử lý việc uỷ quyền ở cấp tập lệnh. Các ứng dụng nhắn tin yêu cầu uỷ quyền không thể thực hiện bất kỳ hành động nào cho đến khi người dùng uỷ quyền cho ứng dụng Nhắn tin. Để đăng tin trước khi uỷ quyền, bạn có thể thêm đối tượng addToSpaceFallbackMessage vào tệp kê khai. Nếu ứng dụng Chat của bạn yêu cầu logic khởi chạy, bạn có thể cần sao chép logic này trong thao tác onMessage.

Ví dụ sau đây cho thấy một ứng dụng Chat phản hồi bằng tin nhắn chào mừng mặc định khi người dùng thêm ứng dụng đó vào một không gian Chat:

        "chat": {
          "addToSpaceFallbackMessage": "Thank you for adding me!"
        }
        

dependencies

object (Dependencies)

Cấu hình của dịch vụ nâng caothư viện được bật để dự án tập lệnh sử dụng.

exceptionLogging

string

Vị trí ghi lại các ngoại lệ. Sau đây là các chế độ cài đặt hợp lệ:

  • NONE cho biết các trường hợp ngoại lệ không được ghi lại.
  • STACKDRIVER cho biết các ngoại lệ được ghi lại trong Stackdriver.
executionApi

object (ExecutionApi)

Cấu hình thực thi API của dự án tập lệnh. Phương thức này chỉ được sử dụng nếu dự án được triển khai để thực thi API.

oauthScopes[]

string

Định nghĩa về phạm vi uỷ quyền mà dự án tập lệnh sử dụng.

runtimeVersion

string

Phiên bản thời gian chạy mà tập lệnh đang sử dụng. Nếu trường này không có trong tệp kê khai, thì tập lệnh sẽ sử dụng thời gian chạy mặc định (STABLE). Sau đây là các tuỳ chọn hợp lệ cho trường này:

  • STABLE cho biết môi trường thời gian chạy mặc định (hiện là Rhino).
  • V8 cho biết môi trường thời gian chạy do V8 hỗ trợ.
  • DEPRECATED_ES5 cho biết môi trường thời gian chạy Rhino. Việc đặt giá trị này cũng ngăn việc di chuyển tự động sang V8.
sheets

object (Sheets)

Cấu hình tài nguyên xác định macros trong Trang tính.

timeZone

string

Múi giờ của tập lệnh trong một trong các giá trị ZoneId có sẵn, chẳng hạn như "America/Denver".

urlFetchWhitelist[]

string

Danh sách tiền tố URL HTTPS. Nếu có, mọi điểm cuối URL được tìm nạp phải khớp với một trong các tiền tố trong danh sách này. Điều này có thể giúp bảo vệ dữ liệu người dùng. Trường này không bắt buộc đối với các bản triển khai kiểm thử, nhưng là trường bắt buộc đối với các bản triển khai. Tìm hiểu thêm về cách đưa URL vào danh sách cho phép.

webapp

object (Webapp)

Cấu hình ứng dụng web của dự án tập lệnh, chỉ được sử dụng nếu dự án được triển khai dưới dạng ứng dụng web.