Trang này được dịch bởi Cloud Translation API.

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

Cấu hình tài nguyên được 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 của 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 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 Google. Hãy 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) } }

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êm thông tin chi tiết.
`conferenceSolution[]`	`object (ConferenceSolution)` Chỉ 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 do tiện ích bổ sung cung cấp. Mỗi giải pháp đều có một lựa chọn hội nghị truyền hình tương ứng xuất hiện 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 đối với dữ liệu do người dùng tạo, dữ liệu sự kiện. Nếu bạn không cung cấp, thì sẽ không có siêu dữ liệu sự kiện nào được truyền đến tiện ích bổ sung. Các chế độ cài đặt hợp lệ là: `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 có thể đọc dữ liệu sự kiện do người dùng tạo ngoài siêu dữ liệu cơ bản về sự kiệ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 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ó phạm vi `https://www.googleapis.com/auth/calendar.addons.current.event.read`. Nếu được đặ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. Lưu ý: Để nhận siêu dữ liệu về sự kiện hiện đang được xem, bạn phải đặt tham số này thành `METADATA`, `READ` hoặc `READ_WRITE`.
`eventOpenTrigger`	`object (EventOpenTrigger)` Quy cách về điều kiện kích hoạt cho điều kiện 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 Google. 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 trong Lịch.
`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)` Quy cách hàm kích hoạt để tạo trang chủ của tiện ích bổ sung trong máy chủ Lịch. Thao tác này sẽ ghi đè `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 lựa chọn hội nghị truyền hình tương ứng xuất hiệ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. Phải là duy nhất trong bộ giải pháp hội nghị truyền hình mà tiện ích bổ sung cung cấp. Sau khi bạn chọn một mã nhận dạng, bạn không nên 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 96 x 96 dp. Đây không thể là một URL tuỳ ý – 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. Nếu được cung cấp, hình ảnh này có thể khác với tiện ích bổ sung `calendar.logoUrl`. Đây là hình ảnh dùng để biểu thị tiện ích bổ sung trong các ứng dụng lưu trữ mà tiện ích bổ sung này 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ì hệ thống 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 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ị 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

Một cấu hình cho trình 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êm thông tin.

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 để 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 gồm 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

Một 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 bài viết 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 hàm Apps Script 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 gồm 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 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 nhấp vào trình cung cấp tệp đính kèm của tiện ích 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 của 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 gồm 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 Lịch, xác định nhà cung cấp tệp đính kèm này.