Tài nguyên tệp kê khai AddOns

Cấu hình tài nguyên được dùng để xác định nội dung và hành vi của Google Workspace Tiện ích bổ sung. Google Workspace Tệp kê khai tiện ích bổ sung phải có tất cả các thành phần được đánh dấu là Bắt buộc.

Tiện ích bổ sung

Cấp cao nhất của Google Workspace cấu hình tệp kê khai tiện ích bổ sung.

Biểu diễn dưới dạng JSON
{
  "common": {
    object (Common)
  },
  "calendar": {
    object (Calendar)
  },
  "drive": {
    object (Drive)
  },
  "gmail": {
    object (Gmail)
  },
  "docs": {
    object (Docs)
  },
  "sheets": {
    object (Sheets)
  },
  "slides": {
    object (Slides)
  }
}
Các trường
common

object (Common)

Bắt buộc. Xác định các giá trị cho một tiện ích bổ sung Google Workspace phổ biến cho mọi ứng dụng lưu trữ. Một số giá trị được xác định ở đây được dùng làm mặc định khi bỏ qua các giá trị cụ thể cho một máy chủ cụ thể.

calendar

object (Calendar)

Bắt buộc nếu Google Workspace tiện ích bổ sung mở rộng Lịch. Cấu hình cho giao diện và hành vi bổ sung của Google Workspace trong ứng dụng lưu trữ Lịch Google. Nếu trường này bị bỏ qua, thì tiện ích bổ sung sẽ bị tắt trong Lịch Google.

drive

object (Drive)

Bắt buộc nếu Google Workspace tiện ích bổ sung mở rộng Google Drive. Cấu hình cho Google Workspace hành vi và giao diện bổ sung trong ứng dụng lưu trữ Google Drive. Nếu trường này bị bỏ qua, thì tiện ích bổ sung sẽ bị tắt trong Google Drive.

gmail

object (Gmail)

Bắt buộc nếu Google Workspace tiện ích bổ sung mở rộng Gmail. Cấu hình cho Google Workspace giao diện và tiện ích bổ sung trong ứng dụng lưu trữ của Gmail. Nếu bạn bỏ qua trường này, tiện ích bổ sung sẽ bị tắt trong Gmail.

docs

object (Docs)

Bắt buộc nếu Google Workspace Tiện ích bổ sung mở rộng Tài liệu. Các cấu hình cho giao diện và hành vi của Google Workspace Tiện ích bổ sung trong ứng dụng lưu trữ Tài liệu. Nếu trường này bị bỏ qua, thì tiện ích bổ sung sẽ bị tắt trong Tài liệu.

sheets

object (Sheets)

Bắt buộc nếu Google Workspace Tiện ích bổ sung mở rộng Trang tính. Cấu hình cho giao diện và hành vi của Google Workspace Tiện ích bổ sung trong ứng dụng lưu trữ Trang tính. Nếu bạn bỏ qua trường này, tiện ích bổ sung sẽ bị tắt trong Trang tính.

slides

object (Slides)

Bắt buộc nếu Google Workspace Tiện ích bổ sung mở rộng Trang trình bày. Cấu hình cho giao diện và hành vi của Google Workspace Tiện ích bổ sung trong ứng dụng lưu trữ Trang trình bày. Nếu trường này bị bỏ qua, thì tiện ích bổ sung sẽ bị tắt trong Trang trình bày.

Phổ biến

Cấu hình tệp kê khai cho các tham số phổ biến đối với mọi ứng dụng lưu trữ. Một số giá trị được xác định ở đây được dùng làm mặc định khi các giá trị cụ thể cho một máy chủ cụ thể bị bỏ qua.

Biểu diễn dưới dạng JSON
{
  "homepageTrigger": {
    object (HomepageTrigger)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "logoUrl": string,
  "name": string,
  "openLinkUrlPrefixes": [
    string
  ],
  "universalActions": [
    {
      object (UniversalAction)
    }
  ],
  "useLocaleFromApp": boolean
}
Các trường
homepageTrigger

object (HomepageTrigger)

Thông số kỹ thuật mặc định của hàm trình kích hoạt để tạo trang chủ bổ sung. Thông số này được sử dụng nếu bạn không xác định trình kích hoạt trang chủ dành riêng cho từng máy chủ. Nếu tính năng này cũng bị bỏ qua, thẻ trang chủ chung sẽ được tạo và sử dụng khi cần.
layoutProperties

object (LayoutProperties)

Cấu hình của các màu dùng trong thanh công cụ tiện ích bổ sung và các nút.
logoUrl

string

Bắt buộc. URL của hình ảnh được hiển thị trên thanh công cụ. URL phải ở chế độ công khai.

name

string

Bắt buộc. Tên của tiện ích bổ sung hiển thị trên thanh công cụ.

openLinkUrlPrefixes[]

string

Bắt buộc nếu tiện ích bổ sung hiển thị bất kỳ đường liên kết ra ngoài nào, dù trong tiện ích sử dụng OpenLink hay tiện ích văn bản có sử dụng thẻ ký tự liên kết HTML. Danh sách các tiền tố URL loại HTTPS. Để bảo vệ dữ liệu người dùng, mọi đường liên kết do tiện ích bổ sung hiển thị phải khớp với một trong các tiền tố trong danh sách này.

Hãy xem phần URL của danh sách cho phép để biết thêm thông tin chi tiết.

universalActions[]

object (UniversalAction)

Danh sách các thao tác phổ biến luôn có sẵn trong giao diện người dùng của tiện ích bổ sung.
useLocaleFromApp

boolean

Nếu true, đối tượng sự kiện tiện ích bổ sung được chuyển vào hàm gọi lại hành động hoặc hàm kích hoạt bao gồm thông tin về ngôn ngữ và múi giờ của người dùng. Giá trị mặc định là false.

Xem phần Truy cập vào múi giờ và ngôn ngữ của người dùng để biết thêm chi tiết.

Bố cục thuộc tính

Cấu hình kiểm soát màu sắc và giao diện của thanh công cụ bổ sung Google Workspace.

Biểu diễn dưới dạng JSON
{
  "primaryColor": string,
  "secondaryColor": string
}
Các trường
primaryColor

string

Màu của thanh công cụ. Mặc định là màu xám (#424242).
secondaryColor

string

Màu mặc định của các nút. Mặc định là màu chính (nếu được đặt); nếu không, màu mặc định là màu xanh lam (#2196F3).

UniversalAction

Cấu hình cho thao tác chung. Khi được chọn, một hành động chung sẽ mở đường liên kết URL được chỉ định hoặc chạy hàm Apps Script được chỉ định.

Biểu diễn dưới dạng JSON
{
  "label": string,

  // Union field rule can be only one of the following:
  "openLink": string,
  "runFunction": string,
  // End of list of possible types for union field rule.

}
Các trường
label

string

Bắt buộc đối với mỗi thao tác chung. Văn bản hiển thị trong trình đơn giao diện người dùng cho thao tác này.
runFunction

string

Bắt buộc đối với mỗi thao tác chung nếu không có openLink. Nếu được cung cấp, tên của hàm Apps Script sẽ thực thi khi người dùng chọn hành động này.

Hãy xem hướng dẫn về Hành động chung để biết thông tin chi tiết.