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

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

  • Lời nhắc là chuông báo được kích hoạt tại một thời điểm cụ thể trước khi sự kiện bắt đầu.
  • Thông báo giúp người dùng biết được những thay đổi đố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ì được gửi đến người dùng, thông báo đẩy sẽ thông báo cho một máy chủ khác về những thay đổi đối với lịch.

Để biết thêm thông tin về thông báo trong Lịch Google, hãy xem bài viết 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 số phút trước thời gian bắt đầu sự kiện
  • Phương thức phân phối cần sử dụng (xem phần 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. Người dùng có thể đặt lời nhắc mặc định cho từng lịch của mình; các giá trị mặc định này áp dụng cho tất cả sự kiện trong lịch đó. Tuy nhiên, người dùng cũng có thể ghi đè các chế độ cài đặt mặc định này cho từng sự kiện, thay thế bằng một bộ 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 đã 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 điều chỉnh thông qua tập hợp CalendarList. Tập hợp này chứa siêu dữ liệu lịch dành riêng cho người dùng
  • Bạn không thể truy cập vào các sự kiện này thông qua tập hợp Lịch. Tập hợp này chứa siêu dữ liệu chung được chia sẻ giữa tất cả 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 đè 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 sẵn reminders.overrides bằng bộ lời nhắc mới.

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

Để quay lại bộ lời nhắc mặc định, hãy cập nhật chế độ cài đặt reminders.useDefault thành 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 một sự kiện mà người dùng được mời tham dự.
  • Huỷ sự kiện: một sự kiện mà người dùng được mời tham dự đã bị huỷ.
  • Câu trả lời của người tham dự: một 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: danh sách tất cả cá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 bật thông báo nào cho mỗi lịch và phương thức gử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ư lời nhắc mặc định, bạn có thể truy cập vào lời nhắc tuỳ chỉnh thông qua bộ sưu tập CalendarList.

Để gửi thông báo qua email cho người tham dự về những sự kiện được chèn hoặc cập nhật bằng API, hãy gọi phương thức insert hoặc update và đặt tham số sendUpdates thành "all" hoặc "externalOnly".

Cơ chế phân phối

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

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

Bảng sau đây cho biết 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 ✓ ✓
Ghi đè lời nhắc ✓ ✓
Thông báo Tạo sự kiện ❌ ✓
Thay đổi sự kiện ❌ ✓
Huỷ sự kiện ❌ ✓
Phản hồi của người tham dự ❌ ✓
Chương trình làm việc ❌ ✓