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 tệp kê khai của 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)
  }
}
Các 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.

dependencies

object (Dependencies)

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

exceptionLogging

string

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

  • 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 vào Stackdriver.
executionApi

object (ExecutionApi)

Cấu hình thực thi API của dự án tập lệnh. Dữ liệu 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 xuất hiện trong tệp kê khai, thì tập lệnh sẽ sử dụng thời gian chạy mặc định (STABLE). Các lựa chọn hợp lệ cho trường này là:

  • 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 chạy bằng V8.
  • DEPRECATED_ES5 cho biết thời gian chạy Rhino. Việc đặt giá trị này cũng ngăn quá trình tự động di chuyển sang V8.
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 theo một trong các giá trị Mã múi giờ hiện có như "Châu Mỹ/Denver".

urlFetchWhitelist[]

string

Danh sách tiền tố URL loại HTTPS. Nếu có, mọi điểm cuối URL được tìm nạp đều 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 hoạt động triển khai kiểm thử, nhưng là bắt buộc đối với hoạt động triển khai. Tìm hiểu thêm về việc đư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 dùng nếu dự án được triển khai dưới dạng một ứng dụng web).