Events: import

Xin lưu ý rằng iCalUID và id không giống nhau và bạn chỉ nên cung cấp một trong hai giá trị này tại thời điểm tạo sự kiện. Một điểm khác biệt về ngữ nghĩa là trong các sự kiện định kỳ, tất cả các lần diễn ra của một sự kiện đều có id riêng, trong khi tất cả đều dùng chung một iCalUID. Để truy xuất một sự kiện bằng iCalUID, hãy gọi phương thức events.list bằng cách sử dụng tham số iCalUID. Để truy xuất một sự kiện bằng id, hãy gọi phương thức events.get.

Để thêm tệp đính kèm từ Google Drive, hãy sử dụng cùng định dạng như trong thuộc tính alternateLink của tài nguyên Files trong API Drive.

Bắt buộc khi thêm tệp đính kèm.

Bắt buộc khi thêm người tham dự.

• "needsAction" – Người tham dự chưa phản hồi lời mời (nên dùng cho các sự kiện mới).
• declined – Người tham dự đã từ chối lời mời.
• "tentative" – Khách mời đã chấp nhận lời mời ở trạng thái dự kiến.
• accepted" – Người tham dự đã chấp nhận lời mời.

Thuộc tính này thay thế thuộc tính colorId dựa trên chỉ mục. Để đặt hoặc thay đổi thuộc tính này, bạn cần chỉ định eventLabelVersion=1 trong các tham số của phương thức insert, import, update và patch.

Nếu bạn đặt một chuỗi trống hoặc không đặt trường này, thì nhãn hiện có sẽ bị xoá khỏi sự kiện.

• "icon" – Tiện ích này xuất hiện bên cạnh tiêu đề của sự kiện trong chế độ xem lịch.
• "chip" – Tiện ích này sẽ xuất hiện khi người dùng nhấp vào sự kiện.

• "email" – Lời nhắc được gửi qua email.
• "popup" – Lời nhắc được gửi qua cửa sổ bật lên trên giao diện người dùng.

Bắt buộc khi thêm lời nhắc.

Bắt buộc khi thêm lời nhắc.

• "confirmed" – Sự kiện đã được xác nhận. Đây là trạng thái mặc định.
• "tentative" – Sự kiện đã được xác nhận tạm thời.
• "cancelled" – Sự kiện bị huỷ (bị xoá). Phương thức list chỉ trả về các sự kiện đã huỷ khi đồng bộ hoá gia tăng (khi bạn chỉ định syncToken hoặc updatedMin) hoặc nếu bạn đặt cờ showDeleted thành true. Phương thức get luôn trả về các giá trị này.

  Trạng thái đã huỷ thể hiện 2 trạng thái khác nhau, tuỳ thuộc vào loại sự kiện:

  1. Các trường hợp ngoại lệ đã huỷ của một sự kiện định kỳ chưa bị huỷ cho biết rằng người dùng sẽ không còn thấy phiên bản này nữa. Ứng dụng nên lưu trữ các sự kiện này trong suốt thời gian diễn ra sự kiện định kỳ mẹ.

     Các ngoại lệ bị huỷ chỉ được đảm bảo có giá trị cho các trường id, recurringEventId và originalStartTime. Các trường khác có thể bị trống.

  2. Tất cả các sự kiện bị huỷ khác đều là sự kiện đã bị xoá. Khách hàng nên xoá các bản sao được đồng bộ hoá cục bộ. Những sự kiện bị huỷ như vậy sẽ biến mất theo thời gian, vì vậy, bạn không nên dựa vào việc chúng sẽ luôn có sẵn.

     Các sự kiện đã xoá chỉ đảm bảo được điền sẵn trường id.

  Trên lịch của người tổ chức, các sự kiện bị huỷ vẫn hiển thị thông tin chi tiết về sự kiện (nội dung tóm tắt, vị trí, v.v.) để có thể khôi phục (xoá) các sự kiện đó. Tương tự, những sự kiện mà người dùng được mời và đã xoá theo cách thủ công vẫn sẽ cung cấp thông tin chi tiết. Tuy nhiên, các yêu cầu đồng bộ hoá gia tăng có showDeleted được đặt thành false sẽ không trả về những thông tin chi tiết này.

  Nếu một sự kiện thay đổi người tổ chức (ví dụ: thông qua thao tác di chuyển) và người tổ chức ban đầu không có trong danh sách người tham dự, thì sự kiện đó sẽ bị huỷ và chỉ có trường id được đảm bảo sẽ được điền sẵn.

• "opaque" – Giá trị mặc định. Sự kiện này sẽ chặn thời gian trên lịch. Điều này tương đương với việc đặt chế độ Hiển thị trạng thái của tôi là thành Bận trong giao diện người dùng Lịch.
• "transparent" – Sự kiện này không chiếm thời gian trên lịch. Điều này tương đương với việc đặt chế độ Hiển thị trạng thái của tôi là thành Rảnh trong giao diện người dùng Lịch.

• "default" – Sử dụng chế độ hiển thị mặc định cho các sự kiện trên lịch. Đây là giá trị mặc định.
• "public" – Sự kiện ở chế độ công khai và tất cả người đọc lịch đều có thể xem thông tin chi tiết về sự kiện.
• "private" – Sự kiện là riêng tư và chỉ người tham dự sự kiện mới có thể xem thông tin chi tiết về sự kiện.
• "confidential" – Sự kiện này là riêng tư. Giá trị này được cung cấp vì lý do tương thích.