CalendarList

Tập hợp lịch trong danh sách lịch của người dùng. Hãy xem thêm phần Lịch và CalendarList.

Để xem danh sách các phương thức cho tài nguyên này, hãy xem ở cuối trang này.

Biểu diễn tài nguyên

{
  "kind": "calendar#calendarListEntry",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "summaryOverride": string,
  "colorId": string,
  "backgroundColor": string,
  "foregroundColor": string,
  "hidden": boolean,
  "selected": boolean,
  "accessRole": string,
  "defaultReminders": [
    {
      "method": string,
      "minutes": integer
    }
  ],
  "notificationSettings": {
    "notifications": [
      {
        "type": string,
        "method": string
      }
    ]
  },
  "primary": boolean,
  "deleted": boolean,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  }
}
Tên tài sản Giá trị Nội dung mô tả Ghi chú
accessRole string Vai trò truy cập hiệu quả của người dùng đã xác thực trên lịch. Chỉ đọc. Các giá trị có thể sử dụng là:
  • "freeBusyReader" – Cấp quyền đọc các thông tin rảnh/bận.
  • "reader" – Cấp quyền đọc lịch. Những người dùng có quyền đọc sẽ thấy các sự kiện riêng tư, nhưng thông tin chi tiết về sự kiện sẽ bị ẩn.
  • "writer" – Cấp quyền đọc và ghi đối với lịch. Người dùng có quyền ghi sẽ thấy được các sự kiện riêng tư và thông tin chi tiết về sự kiện sẽ xuất hiện.
  • "owner" – Cung cấp quyền sở hữu lịch. Vai trò này có tất cả các quyền của vai trò người ghi với khả năng bổ sung để xem và thao tác các ACL.
backgroundColor string Màu chính của lịch ở định dạng thập lục phân "#0088aa". Thuộc tính này thay thế thuộc tính colorId dựa trên chỉ mục. Để thiết lập hoặc thay đổi thuộc tính này, bạn cần chỉ định colorRgbFormat=true trong các thông số của phương thức insert, updatepatch. Không bắt buộc. có thể ghi
colorId string Màu của lịch. Đây là mã nhận dạng tham chiếu đến một mục nhập trong phần calendar của định nghĩa về màu sắc (xem điểm cuối của màu). Thuộc tính này được thay thế bằng các thuộc tính backgroundColorforegroundColor, đồng thời có thể bị bỏ qua khi sử dụng các thuộc tính này. Không bắt buộc. có thể ghi
conferenceProperties nested object Thuộc tính hội nghị truyền hình cho lịch này, chẳng hạn như các loại hội nghị được cho phép.
conferenceProperties.allowedConferenceSolutionTypes[] list Các loại giải pháp hội nghị được hỗ trợ cho lịch này.

Các giá trị có thể là:

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
Không bắt buộc.

defaultReminders[] list Lời nhắc mặc định mà người dùng đã xác thực có đối với lịch này. có thể ghi
defaultReminders[].method string Phương thức mà lời nhắc này sử dụng. Các giá trị có thể sử dụng là:
  • "email" – Lời nhắc được gửi qua email.
  • "popup" – Lời nhắc được gửi qua một cửa sổ bật lên trên giao diện người dùng.

Bắt buộc khi thêm lời nhắc.

có thể ghi
defaultReminders[].minutes integer Số phút trước khi bắt đầu sự kiện khi lời nhắc sẽ kích hoạt. Các giá trị hợp lệ nằm trong khoảng từ 0 đến 40320 (4 tuần tính bằng phút).

Bắt buộc khi thêm lời nhắc.

có thể ghi
deleted boolean Liệu mục nhập danh sách lịch này đã bị xoá khỏi danh sách lịch hay chưa. Chỉ đọc. Không bắt buộc. Giá trị mặc định là False.
description string Nội dung mô tả về lịch. Không bắt buộc. Chỉ đọc.
etag etag ETag của tài nguyên.
foregroundColor string Màu nền trước của lịch ở định dạng thập lục phân "#ffffff". Thuộc tính này thay thế thuộc tính colorId dựa trên chỉ mục. Để thiết lập hoặc thay đổi thuộc tính này, bạn cần chỉ định colorRgbFormat=true trong các thông số của phương thức insert, updatepatch. Không bắt buộc. có thể ghi
hidden boolean Liệu lịch có bị ẩn khỏi danh sách hay không. Không bắt buộc. Thuộc tính này chỉ được trả về khi lịch bị ẩn. Trong trường hợp này, giá trị sẽ là true. có thể ghi
id string Giá trị nhận dạng của lịch.
kind string Loại tài nguyên ("calendar#calendarListEntry").
location string Vị trí địa lý của lịch dưới dạng văn bản dạng tự do. Không bắt buộc. Chỉ đọc.
notificationSettings object Thông báo mà người dùng đã xác thực nhận được đối với lịch này. có thể ghi
notificationSettings.notifications[] list Danh sách thông báo đã được đặt cho lịch này.
notificationSettings.notifications[].method string Phương thức được dùng để gửi thông báo. Giá trị có thể là:
  • "email" – Thông báo được gửi qua email.

Bắt buộc khi thêm thông báo.

có thể ghi
notificationSettings.notifications[].type string Loại thông báo. Các giá trị có thể sử dụng là:
  • "eventCreation" – Thông báo được gửi khi có một sự kiện mới được thêm vào lịch.
  • "eventChange" – Thông báo được gửi khi một sự kiện có sự thay đổi.
  • "eventCancellation" – Thông báo được gửi khi một sự kiện bị huỷ.
  • "eventResponse" – Thông báo được gửi khi một người tham dự phản hồi lời mời tham gia sự kiện.
  • "agenda" – Chương trình làm việc gồm các sự kiện trong ngày (được gửi vào buổi sáng).

Bắt buộc khi thêm thông báo.

có thể ghi
primary boolean Liệu lịch có phải là lịch chính của người dùng đã xác thực hay không. Chỉ đọc. Không bắt buộc. Giá trị mặc định là False.
selected boolean Liệu nội dung lịch có hiển thị trong giao diện người dùng của lịch hay không. Không bắt buộc. Giá trị mặc định là False. có thể ghi
summary string Tên lịch. Chỉ đọc.
summaryOverride string Phần tóm tắt mà người dùng đã xác thực đã đặt cho lịch này. Không bắt buộc. có thể ghi
timeZone string Múi giờ của lịch. Không bắt buộc. Chỉ đọc.

Phương thức

xóa
Xoá lịch khỏi danh sách lịch của người dùng.
nhận
Trả về một lịch từ danh sách lịch của người dùng.
chèn
Chèn một lịch hiện có vào danh sách lịch của người dùng.
list
Trả về các lịch trên danh sách lịch của người dùng.
bản vá
Cập nhật lịch hiện có trên danh sách lịch của người dùng. Phương thức này hỗ trợ ngữ nghĩa bản vá. Hãy lưu ý rằng mỗi yêu cầu bản vá sử dụng 3 đơn vị hạn mức; hãy ưu tiên sử dụng get sau update. Các giá trị của trường mà bạn chỉ định sẽ thay thế các giá trị hiện có. Các trường mà bạn không chỉ định trong yêu cầu sẽ không thay đổi. Các trường mảng, nếu được chỉ định, sẽ ghi đè các mảng hiện có; thao tác này sẽ loại bỏ mọi phần tử mảng trước đó.
cập nhật
Cập nhật lịch hiện có trên danh sách lịch của người dùng.
đồng hồ
Chú ý đến những thay đổi đối với tài nguyên của CalendarList.