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à hoạt động 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 có tất cả các thành phần được đánh dấu là Bắt buộc nếu các thành phần đó mở rộng Lịch.

Lịch

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

string

Chỉ được 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 URL dẫn đến trang cài đặt của tiện ích bổ sung.

Xem bài viết Thêm các chế độ cài đặt tiện ích bổ sung về hội nghị truyền hình để biết thêm thông tin.
conferenceSolution[]

object (ConferenceSolution)

Chỉ được sử dụng nếu tiện ích bổ sung cung cấp giải pháp hội nghị truyền hình. Nếu có, bạn phải xác định ít nhất một giải pháp. Danh sách các giải pháp hội nghị truyền hình mà tiện ích bổ sung này cung cấp. Mỗi giải pháp có một tuỳ chọn hội nghị truyền hình tương ứng được trình bày trong giao diện người dùng Chỉnh sửa sự kiện của Lịch Google.
currentEventAccess

string

Xác định cấp truy cập của tiện ích bổ sung vào dữ liệu sự kiện dữ liệu do người dùng tạo. Nếu bạn không cung cấp thông tin này, thì sẽ không có siêu dữ liệu sự kiện nào được chuyển đến tiện ích bổ sung. Có các chế độ cài đặt hợp lệ như sau:

  • METADATA cho biết rằng tiện ích bổ sung này chỉ có quyền truy cập vào siêu dữ liệu sự kiện cơ bản.
  • READ cho biết rằng tiện ích bổ sung có thể đọc dữ liệu sự kiện do người dùng tạo ngoài siêu dữ liệu sự kiện cơ bản.
  • WRITE cho biết rằng tiện ích bổ sung có thể ghi dữ liệu sự kiện do người dùng tạo.
  • READ_WRITE cho biết rằng tiện ích bổ sung này có thể đọc và ghi dữ liệu sự kiện do người dùng tạo, cũng như đọc siêu dữ liệu cơ bản.

Nếu bạn đặt là READ 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.read.

Nếu được đặt là 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.

eventOpenTrigger

object (EventOpenTrigger)

Thông số kỹ thuật của điều kiện kích hoạt cho sự kiện kích hoạt mở trong Lịch.

eventUpdateTrigger

object (EventUpdateTrigger)

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

eventAttachmentTrigger

object (EventAttachmentTrigger)

Thông số kỹ thuật của điều kiện kích hoạt cho sự kiện kích hoạt tệp đính kèm sự kiện trong Lịch.

homepageTrigger

object (HomepageTrigger)

Thông số kỹ thuật của hàm kích hoạt để tạo trang chủ của tiện ích bổ sung trên Máy chủ lịch. Thao tác này sẽ ghi đè phương thức addOns.common.homepageTrigger.

ConferenceSolution

Cấu hình của một giải pháp hội nghị do tiện ích bổ sung cung cấp. Mỗi giải pháp có một tuỳ chọn hội nghị tương ứng được trình bày 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
}
Các trường
id

string

Bắt buộc. Giá trị nhận dạng cho giải pháp hội nghị truyền hình. Phải là duy nhất trong bộ giải pháp hội nghị truyền hình được cung cấp của tiện ích bổ sung. Bạn không nên thay đổi mã sau khi đã chọn.
logoUrl

string

Một đường liên kết đến biểu tượng đại diện cho giải pháp. Hình ảnh phải có kích thước 96 x 96 dp.

Đây không được là một URL tuỳ ý – hình ảnh phải được lưu trữ trên cơ sở hạ tầng của Google. Xem nội dung Cung cấp biểu trưng cho giải pháp hội nghị để biết thông tin chi tiết.

Nếu được cung cấp, hình ảnh này có thể khác với tiện ích bổ sung calendar.logoUrl. Hình ảnh này dùng để thể hiện tiện ích bổ sung trong các ứng dụng lưu trữ được mở rộng. Nếu bạn không cung cấp hình ảnh biểu trưng cho một giải pháp cụ thể, thì calendar.logoUrl sẽ được dùng.
name

string

Bắt buộc. Tên của giải pháp hội nghị truyền hình sẽ hiển thị trong giao diện người dùng của Lịch Google khi người dùng tạo hoặc chỉnh sửa một sự kiện.
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 chức năng này cho từng giải pháp hội nghị mà tiện ích bổ sung của bạn hỗ trợ.

EventOpenTrigger

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 mở một sự kiện trên Lịch Google. Xem phần Mở rộng giao diện sự kiện trên Lịch để biết thêm thông tin.

Biểu diễn dưới dạng JSON
{
  "runFunction": string
}
Các 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 để xem hoặc chỉnh sửa. Nếu được chỉ định, bạn phải triển khai hàm này để tạo và trả về một mảng các đối tượng Card để hiển thị trong giao diện người dùng của tiện ích bổ sung.

EventUpdateTrigger

Cấu hình cho đ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êm thông tin.

Biểu diễn dưới dạng JSON
{
  "runFunction": string
}
Các trường
runFunction

string

Tên của hàm Apps Script chạy khi người dùng chỉnh sửa và lưu sự kiện trên Lịch. Nếu được chỉ định, bạn phải triển khai hàm này để tạo và trả về một mảng các đối tượng Card để hiển thị trong giao diện người dùng của tiện ích bổ sung.

EventAttachmentTrigger

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

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

string

Bắt buộc. Tên của hàm Apps Script sẽ chạy 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 thả xuống của Lịch. Bạn phải triển khai hàm này để tạo và trả về một mảng các đối tượng Card để hiển thị trong giao diện người dùng của tiện ích bổ sung.
label

string

Bắt buộc. Văn bản sẽ xuất hiện trong trình đơn thả xuống của Lịch để xác định nhà cung cấp tệp đính kèm này.