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 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 Google Workspace cho các tiện ích mở rộng Gmail. Xem bài viết Mở rộng Gmail bằng tiện ích bổ sung 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 kiểm tra uỷ quyền 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ẽ gửi một ngoại lệ từ lệnh gọi chính, như minh hoạ 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 hành động soạn thư. Xác định giao diện người dùng có sẵn khi soạn email.

Xem bài viết Mở rộng giao diện người dùng soạn thư bằng các hành động soạn thư để biết thông tin chi tiết.

contextualTriggers[]

object (ContextualTrigger)

Bắt buộc. Danh sách các trình 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 trình kích hoạt cho trang chủ tiện ích bổ sung trong Gmail. Hàm này sẽ ghi đè addOns.common.homepageTrigger.

ComposeTrigger

Cấu hình cho một hành động soạn thư. Xem bài viết Mở rộng giao diện người dùng soạn thư để 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 truy cập dữ liệu cho một hàm trình kích hoạt soạn thư. 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. Điều này yêu cầu 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 hành động cho mỗi tiện ích bổ sung. Hành động soạn thư có một biểu tượng trong cửa sổ Gmail, được chỉ định bởi gmail.logoUrl.

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ư Gmail. Xem bài viết Mở rộng giao diện người dùng thư để 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 trình kích hoạt theo ngữ cảnh. Tên của hàm Apps Script thực thi khi trình kích hoạt kích hoạt.
unconditional

object

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

SelectAction

Cấu hình hành động soạn thư xác định hàm cần 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 hành động soạn thư. Tên của hàm Apps Script thực thi khi được chọn. Hàm này tạo giao diện người dùng soạn thư của tiện ích bổ sung.
text

string

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