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ọ.

Không nên nhầm lẫn mục sau với mục đẩy thông báo thì thay vì được gửi đi cho người dùng, thông báo cho 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 truy cập 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 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 mình; cá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 đè cho các sự kiện riêng lẻ, thay thế chúng bằng một nhóm lời nhắc.

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

Lời nhắc là thông tin riêng tư, dành riêng cho người dùng đã xác thực; chúng 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 tập hợp CalendarList (Danh sách lịch). 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 thư này thông qua bộ sưu tập Lịch chứa các nội dung chung siêu dữ liệu đượ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 đè 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 đến false rồi điền sẵn reminders.overrides khi đặt 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"
      },
      # ...
  ]
}

Để chuyển về nhóm lời nhắc mặc định, hãy thiết lập chế độ cài đặt cập nhật reminders.useDefault quay 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 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 sẽ bật thông báo nào trên mỗi lịch và chế độ 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 những người dùng khác người dùng. Tương tự như lời nhắc mặc định, bạn có thể truy cập vào những lời nhắc này thông qua Bộ sưu tập Danh sách lịch.

Để 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 qua API, hãy đặt tham số sendNotifications trong phần 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 về sự kiện
Huỷ sự kiện
Phản hồi của người tham dự
Nội dung chính