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

API Lịch 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 vào một thời điểm cụ thể trước khi sự kiện bắt đầu.
  • Thông báo cho phép người dùng tìm hiểu về những thay đổi đối với 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 chi tiết 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

Một 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
  • Phương thức phân phối cầ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. Người dùng có thể đặt lời nhắc mặc định cho từng lịch; các lời nhắc 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 giá trị 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ẻ giữa nhiều người dùng. Kết quả là:

  • Lời nhắc mặc định được thao tác thông qua tập hợp CalendarList, 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 thuộc tính này thông qua bộ sưu tập Lịch. Bộ sưu tậ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 vào 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 trở lại 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ỷ.
  • Phản hồi của người tham dự: người tham dự một sự kiện do người dùng tạo đã thay đổi trạng thái phản hồi.
  • Agenda (Chương trình): 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 bật thông báo nào cho mỗi lịch và phương thức 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ư lời nhắc mặc định, bạn có thể truy cập vào 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.

Cơ chế phân phối

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

  • Bật lên. Các tính năng này được hỗ trợ trên nền tảng di động và trên ứng dụng web.
  • 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ự ❌ ✓
Nội dung chính ❌ ✓