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 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 Google Workspace cho các tiện ích mở rộng Lịch. Hãy xem bài viết Mở rộng Lịch bằng tiện ích bổ sung 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)
  }
}
Trường
createSettingsUrlFunction

string

Chỉ 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 tiện ích bổ sung.

Xem bài viết Thêm chế độ cài đặt 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 các 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 cung cấp. Mỗi giải pháp 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ạn bỏ qua, thì máy chủ 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 sự kiện cơ bản.
  • READ: Quyền truy cập để đọc dữ liệu và siêu dữ liệu sự kiện.
  • WRITE: Quyền truy cập để 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 bạn đặt thành READ hoặc READ_WRITE, thì tiện ích bổ sung phải bao gồm phạm vi https://www.googleapis.com/auth/calendar.addons.current.event.read.

Nếu bạn đặt thành WRITE hoặc READ_WRITE, thì tiện ích bổ sung phải bao gồm https://www.googleapis.com/auth/calendar.addons.current.event.write phạm vi .
eventOpenTrigger

object (EventOpenTrigger)

Thông số kỹ thuật kích hoạt cho các trình kích hoạt mở sự kiện trong Lịch.
eventUpdateTrigger

object (EventUpdateTrigger)

Bắt buộc để cung cấp giao diện cập nhật sự kiện theo bối cảnh trong Lịch. Thông số kỹ thuật điều kiện kích hoạt cho các trình cập nhật sự kiện.
eventAttachmentTrigger

object (EventAttachmentTrigger)

Thông số kỹ thuật 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ủ tiện ích bổ sung trong Lịch. Hàm này sẽ ghi đè addOns.common.homepageTrigger.

ConferenceSolution

Bạn chỉ cần đối tượng tệp kê khai này cho các 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 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. Mã nhận dạng cho giải pháp hội nghị truyền hình. Mã này phải là duy nhất trong tập hợp các giải pháp hội nghị truyền hình. Khô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. Xem bài viết Cung cấp biểu trưng giải pháp hội nghị truyền hình để 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ể, thì tập lệnh sẽ 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 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ị truyền hình này. Bạn phải triển khai hàm này cho từng giải pháp được hỗ trợ.

EventOpenTrigger

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 mở một sự kiện trên Lịch Google. Xem bài viết 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 Card đối tượng cho giao diện người dùng.

EventUpdateTrigger

Cấu hình cho một trình kích hoạt theo bối 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. Xem bài viết 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 một 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 Card đối tượng cho giao diện người dùng.

EventAttachmentTrigger

Cấu hình cho một trình kích hoạt theo bối cảnh sẽ kích hoạt khi người dùng chọn trình cung cấp tệp đính kèm 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 trình cung cấp. Hàm này phải trả về một mảng các Card đối tượng cho giao diện người dùng.
label

string

Bắt buộc. Văn bản trình đơn xác định trình cung cấp tệp đính kèm.