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

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 trong Gmail. Tệp kê khai tiện ích bổ sung của Google Workspace phải bao gồm tất cả cá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 các tiện ích Gmail. Hãy xem phần Mở rộng Gmail bằng tiện ích bổ sung của Google Workspace để biết thông tin chi tiết.

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 hàm Apps Script thực hiện các quy trình kiểm tra uỷ quyền của bên thứ ba.

Hàm này không còn được dùng nữa. Thay vào đó, tiện ích bổ sung sẽ phải gửi một ngoại lệ từ lệnh gọi chính, như trong Ví dụ về cấu hình OAuth không phải của Google.

composeTrigger

object (ComposeTrigger)

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

Hãy xem phần 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ột thư mở trong Gmail. Trình kích hoạt thực thi một hàm Apps Script cụ thể để cập nhật giao diện người dùng.
homepageTrigger

object (HomepageTrigger)

Hàm kích hoạt cho trang chủ của tiện ích bổ sung trong Gmail. Thao tác này sẽ ghi đè addOns.common.homepageTrigger.

ComposeTrigger

Cấu hình cho một thao tác soạn thư. Hãy xem phần Mở rộng giao diện người dùng Compose để biết thông tin chi tiết.

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

string

Xác định cấp độ quyền truy cập dữ liệu cho một hàm kích hoạt thành phần. Các lựa chọn hợp lệ bao gồm:

  • NONE (mặc định): Đối tượng sự kiện hầu như trống.
  • METADATA: Đối tượng sự kiện bao gồm danh sách người nhận. Bạn phải có phạm vi gmail.addons.current.message.metadata.
selectActions[]

object (SelectAction)

Danh sách các hành động soạn thư. Danh sách này chỉ có một thao tác cho mỗi tiện ích bổ sung. Thao tác soạn thư có biểu tượng gmail.logoUrl trong cửa sổ Gmail.

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ở một thư trong Gmail. Hãy xem phần Mở rộng giao diện người dùng thông báo để biết thông tin chi tiết.

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 của hàm Apps Script sẽ thực thi khi điều kiện kích hoạt hoạt động.
unconditional

object

Bắt buộc đối với mỗi điều kiện kích hoạt theo bối cảnh. Chỉ định rằng điều kiện kích hoạt sẽ kích hoạt cho tất cả thư đã mở trong Gmail. Đây phải luôn là một đối tượng trống.

SelectAction

Cấu hình thao tác tạo xác định hàm sẽ chạy khi được chọn.

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 hàm Apps Script sẽ thực thi khi được chọn. Hàm này tạo giao diện người dùng Compose của tiện ích bổ sung.
text

string

Bắt buộc đối với các thao tác soạn thư. Nội dung mô tả ngắn về hành động.