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

Cấu hình tài nguyên dùng để xác định Tiện ích bổ sung của Google Workspace và hành vi trong Lịch Google. Tệp kê khai tiện ích bổ sung của Google Workspace phải có tất 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 tiện ích bổ sung của Google Workspace cho Tiện ích Lịch Google. Xem bài viết 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)
  }
}
Trường
createSettingsUrlFunction

string

Chỉ được dùng nếu tiện ích bổ sung cung cấ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 tiện ích bổ sung.

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

object (ConferenceSolution)

Chỉ được 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ó thì phải có ít nhất một giải pháp xác định. Danh sách các giải pháp hội nghị truyền hình mà tiện ích bổ sung cung cấp. Từng giải pháp có tùy chọn hội nghị truyền hình tương ứng được hiển thị 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 do người dùng tạo dữ liệu sự kiện. Nếu không được cung cấp, 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 chế độ cài đặt hợp lệ như sau:

  • METADATA cho biết tiện ích bổ sung chỉ có quyền truy cập vào siêu dữ liệu cơ bản về sự kiện.
  • READ cho biết tiện ích bổ sung này có thể đọc nội dung do người dùng tạo dữ liệu sự kiện bên cạnh siêu dữ liệu sự kiện cơ bản.
  • WRITE cho biết 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 tiện ích bổ sung 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 thành READ hoặc READ_WRITE thì tiện ích bổ sung phải có https://www.googleapis.com/auth/calendar.addons.current.event.read phạm vi.

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

eventOpenTrigger

object (EventOpenTrigger)

Thông số kỹ thuật về điều kiện kích hoạt cho các điều kiện kích hoạt sự kiện khi mở 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 Google Lịch Google. Thông số kỹ thuật của điều kiện kích hoạt cho trình kích hoạt cập nhật sự kiện trong Lịch Google.

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)

Thông số kỹ thuật của hàm kích hoạt để tạo tiện ích bổ sung homepage trong Máy chủ lưu trữ lịch. Thao tác ghi đè này addOns.common.homepageTrigger.

ConferenceSolution

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 đều có một tuỳ chọn hội nghị truyền hình tương ứng hiển thị 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. Phải duy nhất trong bộ giải pháp hội nghị truyền hình được cung cấp trong tiện ích bổ sung. Sau khi chọn mã nhận dạng, bạn sẽ không thay đổi mã đó.
logoUrl

string

Đườ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 là 96 x 96 dp.

Đây không được là một URL tuỳ ý – hình ảnh phải được lưu trữ trên trang web cơ sở hạ tầng. Xem Cung cấp biểu trưng của giải pháp hội nghị truyền hình để 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 dùng để đại diện tiện ích bổ sung trong các ứng dụng lưu trữ mà nó mở rộng. Nếu hình ảnh biểu trưng không được cung cấp cho một giải pháp cụ thể, Thay vào đó, hệ thống 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 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 hàm 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 điều kiện kích hoạt theo ngữ cảnh kích hoạt khi Lịch Google sự kiện mà người dùng mở. Xem 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
}
Trường
runFunction

string

Tên của chức năng Apps Script sẽ 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 để tạo và trả về một mảng Card để hiển thị trong giao diện người dùng tiện ích bổ sung.

EventUpdateTrigger

Cấu hình cho điều kiện kích hoạt theo ngữ cảnh kích hoạt khi Lịch Google do người dùng chỉnh sửa và lưu. Xem 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
}
Trường
runFunction

string

Tên của chức năng Apps Script sẽ chạy khi người dùng chỉnh sửa và lưu một 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 Card để hiển thị trong giao diện người dùng 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 bổ sung trong trình đơn thả xuống 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 tệp đính kèm tạo bằng tiện ích bổ sung trong trình đơn thả xuống Lịch . Bạn phải triển khai hàm này để tạo và trả về một mảng Card để hiển thị trong giao diện người dùng tiện ích bổ sung.
label

string

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