Lời nhắc và thông báo

Calendar API (API Lịch) hỗ trợ lời nhắc và thông báo.

  • Lời nhắc là các chuông báo được kích hoạt vào một thời điểm cụ thể trước khi một sự kiện bắt đầu.
  • Thông báo cho phép người dùng phát hiện những thay đổi với các sự kiện trong lịch của họ.

Bạn không nên nhầm lẫn mục sau với thông báo đẩy (thay vì gửi cho người dùng), hãy thông báo cho một máy chủ khác về các thay đổi đối với lịch.

Để biết thêm thông tin chi tiết về thông báo trong Lịch Google, hãy chuyển đến phần Sửa đổi thông báo của Lịch Google.

Lời nhắc

Lời nhắc bao gồm:

  • Thời điểm hiển thị lời nhắc, được biểu thị bằng phút trước thời gian bắt đầu sự kiện
  • Cách phân phối nên sử dụng (xem Cơ chế phân phối)

Bạn có thể chỉ định lời nhắc cho toàn bộ lịch và cho từng sự kiện riêng lẻ. Người dùng có thể đặt lời nhắc mặc định cho từng lịch của mình; những lời nhắc mặc định này áp dụng cho mọi sự kiện trong lịch đó. Tuy nhiên, người dùng cũng có thể ghi đè các chế độ mặc định này cho từng sự kiện và thay thế bằng một nhóm lời nhắc khác.

Lời nhắc mặc định

Lời nhắc là thông tin riêng tư dành riêng cho một người dùng đã được xác thực. Lời nhắc không được chia sẻ cho nhiều người dùng. Kết quả là:

  • Lời nhắc mặc định được chỉnh sửa thông qua bộ sưu tập CalendarList, chứa siêu dữ liệu lịch của người dùng cụ thể
  • Bạn không thể truy cập vào những sự kiện này thông qua bộ sưu tập Lịch chứa siêu dữ liệu toàn cầu được chia sẻ cho mọi người dùng.

Lời nhắc mặc định cũng được trả về khi thực hiện truy vấn danh sách Sự kiện.

Ghi đè lời nhắc mặc định

Để ghi đè các lời nhắc mặc định khi bạn chèn hoặc sửa đổi một sự kiện, hãy đặt reminders.useDefault thành false và điền vào reminders.overrides bằng lời nhắc mới đã đặt.

"reminders": {
  "useDefault": false,
  # Overrides can be set if and only if useDefault is false.
  "overrides": [
      {
        "method": "reminderMethod",
        "minutes": "reminderMinutes"
      },
      # ...
  ]
}

Để quay lại nhóm lời nhắc mặc định, hãy cập nhật chế độ cài đặt reminders.useDefault cho true.

Thông báo

Lịch hỗ trợ các loại thông báo sau:

  • Tạo sự kiện: một sự kiện mới được thêm vào một trong các lịch của người dùng.
  • Thay đổi sự kiện: người tổ chức đã sửa đổi sự kiện mà người dùng được mời tham gia.
  • Huỷ sự kiện: một sự kiện bị huỷ mà người dùng được mời tham dự.
  • Phản hồi của người tham dự: người tham dự sự kiện do người dùng tạo đã thay đổi trạng thái phản hồi của họ.
  • Chương trình làm việc: danh sách tất cả sự kiện trong lịch của người dùng, được gửi vào đầu ngày.

Người dùng có thể quyết định những thông báo nào cần bật trên mỗi lịch và cách phân phối cho từng loại thông báo. Các chế độ cài đặt này không được chia sẻ với người dùng khác. Tương tự như các lời nhắc mặc định, bạn có thể truy cập các lời nhắc này thông qua bộ sưu tập CalendarList.

Để gửi thông báo qua email cho người tham dự về các sự kiện đã được chèn hoặc cập nhật thông qua API, hãy đặt tham số sendNotifications trong yêu cầu chèn/cập nhật thành true (đúng).

Cơ chế phân phối

Các phương thức phân phối do Lịch Google cung cấp là:

  • Cửa sổ bật lên. Các trình xử lý này được hỗ trợ trên nền tảng di động và trên các ứng dụng web.
  • Email do máy chủ gửi.

Bảng sau đây trình bày các phương thức được hỗ trợ cho từng loại lời nhắc hoặc thông báo:

Cửa sổ bật lên Email
Lời nhắc Lời nhắc mặc định ✓ ✓
Lời nhắc ghi đè ✓ ✓
Thông báo Tạo sự kiện ❌ ✓
Thay đổi sự kiện ❌ ✓
Huỷ sự kiện ❌ ✓
Câu trả lời của người tham dự ❌ ✓
Nội dung chính ❌ ✓