Tài nguyên tệp kê khai của Tiện ích bổ sung

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

AddOns

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

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)
  }
}
Trường
common

object (Common)

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

calendar

object (Calendar)

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

drive

object (Drive)

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

gmail

object (Gmail)

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

docs

object (Docs)

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

sheets

object (Sheets)

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

slides

object (Slides)

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

Phổ biến

Cấu hình tệp kê khai cho các thông số thường dùng 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 các giá trị cụ thể cho một thuộc tính máy chủ lưu trữ 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
}
Trường
homepageTrigger

object (HomepageTrigger)

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

object (LayoutProperties)

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

string

Bắt buộc. URL của hình ảnh xuất hiện 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 xuất hiện 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, cho dù trong các tiện ích sử dụng OpenLink hoặc tiện ích văn bản bằng cách sử dụng thẻ liên kết HTML. Danh sách URL loại HTTPS tiền tố. Để 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ị đều phải khớp với một trong các tiền tố trong danh sách này.

Xem 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 ngôn ngữ chung các hành động luôn có sẵn trong giao diện người dùng tiện ích bổ sung.
useLocaleFromApp

boolean

Nếu là true, tiện ích bổ sung các đối tượng sự kiện được truyền đến hàm callback action hoặc hàm kích hoạt. thông tin về ngôn ngữ và múi giờ của người dùng. Mặc định là false.

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

LayoutProperties

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

Biểu diễn dưới dạng JSON
{
  "primaryColor": string,
  "secondaryColor": string
}
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 là set); nếu không, mặc định thành màu xanh lam (#2196F3).

UniversalAction

Cấu hình cho một thao tác chung. Khi được chọn, một thao tác chung sẽ mở liên kết URL đã 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.

}
Trường
label

string

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

string

Bắt buộc cho mỗi hành động chung nếu openLink là không tồn tại. Nếu được cung cấp, thì tên của Ứng dụng Hàm tập lệnh thực thi khi người dùng chọn thao tác này.

Hãy xem Hướng dẫn về các thao tác chung để biết thông tin chi tiết.