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 nội dung và hành vi của tiện ích bổ sung Google Workspace. Tệp kê khai tiện ích bổ sung của Google Workspace phải có tất cả các thành phần được đánh dấu là Bắt buộc.

AddOns

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

Biểu diễn dưới dạng JSON 
{
  "common": {
    object (Common)
  },
  "calendar": {
    object (Calendar)
  },
  "chat": {
    object (Chat)
  },
  "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 các giá trị cho tiện ích bổ sung của Google Workspace thường dùng cho mọi ứng dụng lưu trữ. Một số giá trị được xác định ở đây sẽ được dùng làm giá trị mặc định khi bạn bỏ qua các giá trị cụ thể cho một máy chủ lưu trữ cụ thể.

calendar

object (Calendar)

Bắt buộc nếu tiện ích bổ sung Google Workspace mở rộng Lịch. Cấu hình cho 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 bạn bỏ qua trường này, thì tiện ích bổ sung sẽ bị tắt trong Lịch Google.

chat

object ()

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

Đối tượng addOns.chat phải trống. Để định cấu hình hành vi và giao diện của tiện ích bổ sung trong Chat, hãy xem phần Định cấu hình ứng dụng Chat.
drive

object (Drive)

Bắt buộc nếu tiện ích bổ sung Google Workspace mở rộng Google Drive. Cấu hình cho 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 bạn bỏ qua trường này, tiện ích bổ sung sẽ bị tắt trong Google Drive.

gmail

object (Gmail)

Bắt buộc nếu tiện ích bổ sung Google Workspace mở rộng Gmail. Cấu hình cho 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 bạn bỏ qua trường này, tiện ích bổ sung sẽ bị vô hiệu hoá trong Gmail.

docs

object (Docs)

Bắt buộc nếu tiện ích bổ sung 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 Google Workspace trong ứng dụng lưu trữ Tài liệu. Nếu bạn bỏ qua trường này, thì tiện ích bổ sung sẽ bị tắt trong Tài liệu.

sheets

object (Sheets)

Bắt buộc nếu tiện ích bổ sung 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 Google Workspace trong ứng dụng lưu trữ Trang tính. Nếu bạn bỏ qua trường này, thì tiện ích bổ sung sẽ bị vô hiệu hoá trong Trang tính.

slides

object (Slides)

Bắt buộc nếu tiện ích bổ sung Google Workspace mở rộng Google Trang trình bày. Cấu hình cho giao diện và hành vi của tiện ích bổ sung Google Workspace trong ứng dụng lưu trữ Trang trình bày. Nếu bạn bỏ qua trường này, 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ố thường gặp đối với mọi ứng dụng lưu trữ. Một số giá trị được xác định ở đây sẽ được dùng làm giá trị mặc định khi bạn bỏ qua các giá trị cụ thể cho một máy chủ lưu trữ cụ thể.

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 hàm kích hoạt mặc định để tạo trang chủ của tiện ích bổ sung. Quy cách này được dùng nếu bạn không xác định một trình kích hoạt trang chủ dành riêng cho máy chủ lưu trữ. Nếu bạn bỏ qua cả hai tham số này, một thẻ trang chủ chung sẽ được tạo và sử dụng khi cần.
layoutProperties

object (LayoutProperties)

Cấu hình cho màu sắc được 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 là URL 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 bên ngoài nào, cho dù là trong các tiện ích bằng cách sử dụng OpenLink hay tiện ích văn bản bằng cách sử dụng thẻ liên kết HTML. Danh sách tiền tố URL HTTPS. Để bảo vệ dữ liệu người dùng, mọi đường liên kết mà 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.

Hãy xem phần Cho phép URL để biết thêm thông tin chi tiết.

universalActions[]

object (UniversalAction)

Danh sách các thao tác chung 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, các đối tượng sự kiện của tiện ích bổ sung được truyền đến các 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.

Hãy xem phần 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.

LayoutProperties

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

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ụ. Giá trị 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ặc định là màu xanh dương (#2196F3).

UniversalAction

Một cấu hình cho thao tác chung. Khi được chọn, thao tác chung sẽ mở đường liên kết URL đã chỉ định hoặc chạy hàm Apps Script đã 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 từng hành động phổ biến. Văn bản xuất hiện 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 từng 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 thao tác này.

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