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

API Lịch cung cấp hỗ trợ cho 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 sự kiện bắt đầu.
  • Thông báo giúp người dùng biết về 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, loại thông báo này thay vì được phân phố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ề các 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.

Nhắc nhở

Lời nhắc bao gồm:

  • Thời điểm hiện 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 pháp phân phối sẽ 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ủa họ; những chế độ 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 giá trị mặc định này cho từng sự kiện, thay thế chúng 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ư của người dùng đã xác thực và không được chia sẻ cho nhiều người dùng. Kết quả là:

  • Lời nhắc mặc định được thao tác thông qua bộ sưu tậ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 trang này thông qua tập hợp Lịch, nơi chứa siêu dữ liệu chung được chia sẻ cho 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 đè 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 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 về nhóm 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 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 gia.
  • Phản hồi của người tham dự: một 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 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 loại thông báo sẽ bật trên 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 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 thông 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 gửi:

  • Cửa sổ bật lên. Các định dạng này được hỗ trợ trên nền tảng di động và ứ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 ✓ ✓
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 ❌ ✓