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

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

Cấu trúc con 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)
  },
  "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 một tiện ích bổ sung của Google Workspace.

dependencies

object (Dependencies)

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

exceptionLogging

string

Vị trí ghi nhật ký các ngoại lệ. Các chế độ cài đặt hợp lệ như sau:

  • NONE cho biết các 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 có thể thực thi API của dự án tập lệnh. Tính năng này chỉ được 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 môi trường thời gian chạy mặc định (STABLE). Các tuỳ chọn hợp lệ cho trường này như sau:

  • STABLE cho biết thời gian chạy mặc định (hiện là Rhino).
  • V8 cho biết thời gian chạy có hỗ trợ V8.
  • DEPRECATED_ES5 cho biết thời gian chạy của Rhino. Việc đặt giá trị này cũng sẽ ngăn quá trình tự động di chuyển sang phiên bản 8.
sheets

object (Sheets)

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

timeZone

string

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

string

Danh sách các tiền tố URL loại 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. Việc 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 khi triển khai kiểm thử, nhưng là trường bắt buộc đối với các đợt triển khai. Tìm hiểu thêm về URL trong 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. Cấu hình này chỉ được dùng nếu dự án được triển khai dưới dạng ứng dụng web.