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

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

Gmail

Cấu hình tệp kê khai tiện ích bổ sung của Google Workspace cho Tiện ích Gmail. Xem Mở rộng Gmail bằng tiện ích bổ sung của Google Workspace để biết thêm thông tin.

Biểu diễn dưới dạng JSON
{
  "authorizationCheckFunction": string,
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
Trường
authorizationCheckFunction

string

Không dùng nữa. Tên của một chức năng trong Apps Script hoạt động kiểm tra yêu cầu uỷ quyền của bên thứ ba. Hàm này được gọi trước mỗi lần gọi lệnh Tiện ích bổ sung của Google Workspace.

Hàm này không được dùng nữa để tránh độ trễ thực thi không cần thiết. Thay vào đó, tiện ích bổ sung sẽ gửi một ngoại lệ từ như được thể hiện trong đoạn mã này ví dụ.

composeTrigger

object (ComposeTrigger)

Bắt buộc đối với các thao tác soạn thư. Xác định tập hợp giao diện người dùng có sẵn cho người dùng trong khi soạn email.

Xem Mở rộng giao diện người dùng Compose bằng các thao tác Compose để biết thông tin chi tiết.

contextualTriggers[]

object (ContextualTrigger)

Bắt buộc. Danh sách các điều kiện kích hoạt sẽ kích hoạt khi mở thư trong Gmail. Khi kích hoạt, điều kiện kích hoạt sẽ thực thi một thao tác cụ thể Chức năng của Apps Script, thường là để tạo thẻ mới và cập nhật giao diện người dùng.
homepageTrigger

object (HomepageTrigger)

Thông số kỹ thuật của hàm kích hoạt để tạo tiện ích bổ sung homepage trong Máy chủ Gmail. Thao tác ghi đè này addOns.common.homepageTrigger.

ComposeTrigger

Cấu hình cho một thao tác soạn thư. Xem Mở rộng giao diện người dùng Compose để biết thêm thông tin.

Biểu diễn dưới dạng JSON
{
  "draftAccess": string,
  "selectActions": [
    {
      object (SelectAction)
    }
  ]
}
Trường
draftAccess

string

Xác định cấp truy cập dữ liệu dành cho một điều kiện kích hoạt trong Compose . Có các lựa chọn hợp lệ như sau:

  • NONE, chế độ cài đặt mặc định. Điều này khiến sự kiện được truyền đến hàm kích hoạt Compose chủ yếu trống.
  • METADATA điền sẵn đối tượng sự kiện được truyền vào hàm kích hoạt Compose có danh sách người nhận . Chế độ cài đặt này yêu cầu tiện ích bổ sung phải có gmail.addons.current.message.metadata phạm vi.
selectActions[]

object (SelectAction)

Danh sách các thao tác trong Compose tạo ra giao diện người dùng Compose; tuy nhiên, việc này danh sách được giới hạn ở một hành động duy nhất cho mỗi tiện ích bổ sung. Người soạn có biểu tượng tương ứng được hiển thị trong cửa sổ soạn thư của Gmail. Biểu tượng này do gmail.logoUrl chỉ định.

ContextualTrigger

Cấu hình cho một điều kiện kích hoạt sẽ kích hoạt khi người dùng mở thư trong Gmail và thông báo đó đáp ứng các tiêu chí nhất định. Xem Mở rộng giao diện người dùng của thông báo để biết thêm thông tin.

Biểu diễn dưới dạng JSON
{
  "onTriggerFunction": string,
  "unconditional": {},
}
Trường
onTriggerFunction

string

Bắt buộc đối với mỗi điều kiện kích hoạt theo bối cảnh. Tên ứng dụng Hàm tập lệnh thực thi khi điều kiện kích hoạt kích hoạt.

Xem Hàm kích hoạt theo ngữ cảnh để biết thông tin chi tiết về cách xác định hàm này .

unconditional

object

Bắt buộc đối với mỗi điều kiện kích hoạt theo bối cảnh. Dùng để chỉ định rằng trình kích hoạt theo ngữ cảnh sẽ kích hoạt cho tất cả thư Gmail khi các thư đó đã mở. Hiện tại, đây là tuỳ chọn duy nhất, vì vậy đây phải luôn là tuỳ chọn đối tượng trống.

SelectAction

Cấu hình thao tác Compose xác định hàm nào sẽ chạy khi người dùng chọn thao tác soạn thư.

Biểu diễn dưới dạng JSON
{
  "runFunction": string,
  "text": string
}
Trường
runFunction

string

Bắt buộc đối với các thao tác soạn thư. Tên của Apps Script hàm thực thi khi thao tác soạn thư này được chọn. Chiến dịch này hàm kích hoạt Compose tạo giao diện người dùng tiện ích bổ sung trong Compose.

Xem Hàm kích hoạt Compose để biết thông tin chi tiết.

text

string

Bắt buộc đối với các thao tác soạn thư. Nội dung mô tả ngắn gọn bằng văn bản về vấn đề này thao tác soạn thư.