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 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 tệp kê khai tiện ích bổ sung Google Workspace cấp cao nhất.

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 một 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 các giá trị cụ thể cho một ứng dụng lưu trữ bị bỏ qua.

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 giao diện và hành vi trong ứng dụng lưu trữ Lịch Google. Nếu bị bỏ qua, 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ị 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 Chat, hãy xem bài viết Định cấu hình ứng dụng 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 giao diện và hành vi trong ứng dụng lưu trữ Drive. Nếu bị bỏ qua, 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 giao diện và hành vi trong ứng dụng lưu trữ Gmail. Nếu bị bỏ qua, tiện ích bổ sung sẽ bị tắt 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ị bỏ qua, 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 giao diện và hành vi trong ứng dụng lưu trữ Trang tính. Nếu bị bỏ qua, 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 giao diện và hành vi trong ứng dụng lưu trữ Trang trình bày. Nếu bị bỏ qua, 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 giao diện và hành vi trong ứng dụng lưu trữ Meet. 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ố 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 các giá trị cụ thể cho một ứng dụng lưu trữ 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)

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

object (LayoutProperties)

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

string

Bắt buộc. URL công khai của hình ảnh thanh công cụ.
name

string

Bắt buộc. Tên của tiện ích bổ sung xuất hiện trong 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 đi ra ngoài trong các tiện ích bằng cách sử dụng OpenLink hoặc tiện ích văn bản bằng thẻ neo 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 hiển thị phải khớp với một tiền tố trong danh sách này.

Xem bài viết Danh sách cho phép URL để biết thông tin chi tiết.

universalActions[]

object (UniversalAction)

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

boolean

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

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

LayoutProperties

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

string

Màu nút mặc định. Giá trị mặc định là màu chính nếu được đặt; nếu không, giá trị mặc định là màu xanh dương (#2196F3).

UniversalAction

Cấu hình cho một thao tác phổ biến. Khi được chọn, một thao tác phổ biến 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 mỗi thao tác 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 phổ biến nếu thiếu openLink là thiếu. Tên của hàm Apps Script sẽ thực thi khi được chọn.

Xem hướng dẫn về Thao tác phổ biến để biết thông tin chi tiết.