Tài nguyên tệp kê khai lịch

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 Lịch Google. Tệp kê khai của 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 Lịch.

Lịch

Cấu hình tệp kê khai tiện ích bổ sung của Google Workspace cho các tiện ích Lịch. Hãy xem phần Mở rộng Lịch bằng các 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
{ "createSettingsUrlFunction": string, "conferenceSolution": [ { object (ConferenceSolution) } ], "currentEventAccess": string, "eventOpenTrigger": { object (EventOpenTrigger) }, "eventUpdateTrigger": { object (EventUpdateTrigger) }, "eventAttachmentTrigger": { object (EventAttachmentTrigger) }, "homepageTrigger": { object (HomepageTrigger) } }

Biểu diễn dưới dạng JSON

{
  "createSettingsUrlFunction": string,
  "conferenceSolution": [
    {
      object (ConferenceSolution)
    }
  ],
  "currentEventAccess": string,
  "eventOpenTrigger": {
    object (EventOpenTrigger)
  },
  "eventUpdateTrigger": {
    object (EventUpdateTrigger)
  },
  "eventAttachmentTrigger": {
    object (EventAttachmentTrigger)
  },
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}

Trường
`createSettingsUrlFunction`	`string` Chỉ sử dụng nếu tiện ích bổ sung cung cấp các giải pháp hội nghị truyền hình. Không bắt buộc. Tên của hàm Apps Script tạo ra một URL dẫn đến trang cài đặt của tiện ích bổ sung. Xem phần Thêm chế độ cài đặt của tiện ích bổ sung hội nghị truyền hình để biết thông tin chi tiết.
`conferenceSolution[]`	`object (ConferenceSolution)` Chỉ dùng nếu tiện ích bổ sung cung cấp giải pháp hội nghị truyền hình; bạn phải xác định ít nhất một giải pháp. Các giải pháp hội nghị truyền hình do tiện ích bổ sung này cung cấp. Mỗi giải pháp sẽ xuất hiện dưới dạng một lựa chọn trong giao diện người dùng Chỉnh sửa sự kiện của Lịch.
`currentEventAccess`	`string` Xác định cấp truy cập mà tiện ích bổ sung có đối với dữ liệu sự kiện. Nếu bỏ qua, máy chủ lưu trữ sẽ không truyền siêu dữ liệu sự kiện. Các chế độ cài đặt hợp lệ bao gồm: `METADATA`: Quyền truy cập vào siêu dữ liệu cơ bản của sự kiện. `READ`: Quyền truy cập để đọc dữ liệu sự kiện và siêu dữ liệu. `WRITE`: Quyền ghi dữ liệu sự kiện. `READ_WRITE`: Quyền truy cập để đọc và ghi dữ liệu sự kiện cũng như siêu dữ liệu. Nếu được đặt thành `READ` hoặc `READ_WRITE`, tiện ích bổ sung phải có phạm vi `https://www.googleapis.com/auth/calendar.addons.current.event.read`. Nếu được đặt thành `WRITE` hoặc `READ_WRITE`, thì tiện ích bổ sung phải có phạm vi `https://www.googleapis.com/auth/calendar.addons.current.event.write`. Để truy xuất siêu dữ liệu cho sự kiện hiện tại, hãy đặt tham số này thành `METADATA`, `READ` hoặc `READ_WRITE`.
`eventOpenTrigger`	`object (EventOpenTrigger)` Quy cách kích hoạt cho các trình kích hoạt mở sự kiện trong Lịch.
`eventUpdateTrigger`	`object (EventUpdateTrigger)` Bạn phải cung cấp giao diện cập nhật sự kiện theo bối cảnh trong Lịch. Quy cách kích hoạt cho các điều kiện kích hoạt cập nhật sự kiện.
`eventAttachmentTrigger`	`object (EventAttachmentTrigger)` Quy cách kích hoạt cho các trình kích hoạt tệp đính kèm sự kiện trong Lịch.
`homepageTrigger`	`object (HomepageTrigger)` Hàm kích hoạt cho trang chủ của tiện ích bổ sung trong Lịch. Thao tác này sẽ ghi đè `addOns.common.homepageTrigger`.

ConferenceSolution

Đối tượng tệp kê khai này chỉ bắt buộc đối với những tiện ích bổ sung mở rộng Lịch bằng các giải pháp hội nghị truyền hình của bên thứ ba.

Cấu hình của một giải pháp hội nghị truyền hình do tiện ích bổ sung cung cấp. Mỗi giải pháp sẽ xuất hiện dưới dạng một lựa chọn trong giao diện người dùng Chỉnh sửa sự kiện của Lịch Google.

Biểu diễn dưới dạng JSON
{ "id": string, "logoUrl": string, "name": string, "onCreateFunction": string }

Trường
`id`	`string` Bắt buộc. Giá trị nhận dạng của giải pháp hội nghị truyền hình. Giá trị này phải là duy nhất trong bộ giải pháp hội nghị. Đừng thay đổi mã nhận dạng sau khi chọn.
`logoUrl`	`string` Đường liên kết đến biểu tượng giải pháp. Hình ảnh phải có kích thước 96 x 96 dp. Hình ảnh phải được lưu trữ trên cơ sở hạ tầng của Google. Hãy xem phần Cung cấp biểu trưng của giải pháp hội nghị để biết thông tin chi tiết. Hình ảnh này có thể khác với tiện ích bổ sung `calendar.logoUrl`. Nếu bạn bỏ qua một giải pháp cụ thể, tập lệnh sẽ dùng `calendar.logoUrl`.
`name`	`string` Bắt buộc. Tên của giải pháp hội nghị truyền hình xuất hiện trong giao diện người dùng của Lịch Google.
`onCreateFunction`	`string` Bắt buộc. Tên của hàm Apps Script được gọi khi Lịch Google cố gắng tạo loại hội nghị này. Bạn phải triển khai hàm này cho từng giải pháp được hỗ trợ.

EventOpenTrigger

Một cấu hình cho điều kiện kích hoạt theo bối cảnh sẽ kích hoạt khi người dùng mở một sự kiện trên Lịch Google. Hãy xem phần Mở rộng giao diện sự kiện trên Lịch để biết thông tin chi tiết.

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

Trường
`runFunction`	`string` Tên của hàm Apps Script chạy khi người dùng mở một sự kiện trên Lịch. Hàm này phải trả về một mảng các đối tượng `Card` cho giao diện người dùng.

EventUpdateTrigger

Cấu hình cho một điều kiện kích hoạt theo ngữ cảnh sẽ kích hoạt khi người dùng chỉnh sửa và lưu một sự kiện trên Lịch Google. Hãy xem phần Cập nhật sự kiện trên Lịch để biết thông tin chi tiết.

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

Trường
`runFunction`	`string` Tên của hàm Apps Script chạy khi người dùng lưu một sự kiện đã chỉnh sửa trên Lịch. Hàm này phải trả về một mảng các đối tượng `Card` cho giao diện người dùng.

EventAttachmentTrigger

Cấu hình cho một điều kiện kích hoạt theo bối cảnh sẽ kích hoạt khi người dùng chọn nhà cung cấp tệp đính kèm của tiện ích bổ sung trong trình đơn Lịch.

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

Trường
`runFunction`	`string` Bắt buộc. Tên của hàm Apps Script chạy khi người dùng chọn nhà cung cấp. Hàm này phải trả về một mảng các đối tượng `Card` cho giao diện người dùng.
`label`	`string` Bắt buộc. Văn bản trong trình đơn xác định nhà cung cấp tệp đính kèm.