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

Cấu hình tài nguyên được 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 phải bao gồm 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 của 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)
  },
  "meet": {
    object (Meet)
  }
}
Trường
common

object (Common)

Bắt buộc. Xác định các giá trị cho tiện ích bổ sung Google Workspace thường dùng cho mọi ứng dụng lưu trữ. Các giá trị được xác định ở đây đóng vai trò là 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 về giao diện và hành vi trong ứng dụng lưu trữ Lịch Google. Nếu bạn bỏ qua tham số này, 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, 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 Google Chat, hãy xem phần Định cấu hình ứng dụng nhắn tin Google Chat.

drive

object (Drive)

Bắt buộc nếu tiện ích bổ sung Google Workspace mở rộng Drive. Cấu hình về giao diện và hành vi trong ứng dụng lưu trữ Drive. Nếu bạn bỏ qua tham số này, tiện ích bổ sung sẽ bị tắt trong 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 về giao diện và hành vi trong ứng dụng lưu trữ Gmail. Nếu bỏ qua, 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 giao diện và hành vi trong ứng dụng lưu trữ Tài liệu. Nếu bạn bỏ qua tham số này, tiện ích bổ sung sẽ bị vô hiệu hoá 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 về giao diện và hành vi trong ứng dụng lưu trữ Trang tính. Nếu bạn bỏ qua tham số này, tiện ích bổ sung sẽ bị tắt trong Trang tính.

slides

object (Slides)

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

meet

object (Meet)

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

Phổ biến

Cấu hình tệp kê khai cho các tham số chung của mọi ứng dụng lưu trữ. Các giá trị được xác định ở đây đóng vai trò là 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ữ.

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)

Hàm kích hoạt mặc định cho tiện ích bổ sung trang chủ. Quy cách này được dùng nếu bạn không xác định một điều kiện kích hoạt trang chủ dành riêng cho máy chủ lưu trữ. Nếu bạn bỏ qua, hệ thống sẽ sử dụng thẻ trang chủ chung.
layoutProperties

object (LayoutProperties)

Cấu hình cho các màu đượ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ông khai của hình ảnh trên thanh công cụ.
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ị các đường liên kết bên ngoài trong tiện ích bằng cách sử dụng OpenLink hoặc tiện ích văn bản bằ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, các đường liên kết do tiện ích bổ sung này hiển thị phải khớp với một tiền tố trong danh sách này.

Hãy xem phần Cho phép URL để biết 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 các hàm kích hoạt bao gồm 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ông tin chi tiết.

LayoutProperties

Cấu hình cho thanh công cụ và giao diện nút của 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 thanh công cụ. Giá trị mặc định là màu xám (#424242).
secondaryColor

string

Màu nút mặc định. 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

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

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 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 thiếu openLink. Tên của hàm Apps Script sẽ thực thi khi được chọn.

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