Calendars

Một bộ sưu tập gồm tất cả các lịch hiện có. Xem thêm Calendars vs CalendarList (Lịch so với CalendarList).

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

Cách trình bày tài nguyên

{
  "kind": "calendar#calendar",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "dataOwner": string,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  }
}
Tên tài sản Giá trị Mô tả Ghi chú
conferenceProperties nested object Các thuộc tính hội nghị cho lịch này, chẳng hạn như những loại hội nghị được 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.
dataOwner string Email của chủ sở hữu lịch. Chỉ đặt cho lịch phụ. Chỉ đọc.
description string Nội dung mô tả về lịch. Không bắt buộc. có thể ghi
etag etag ETag của tài nguyên.
id string Giá trị nhận dạng của lịch. Để truy xuất mã nhận dạng, hãy gọi phương thức calendarList.list().
kind string Loại tài nguyên ("calendar#calendar").
location string Vị trí địa lý của lịch dưới dạng văn bản tự do. Không bắt buộc. có thể ghi
summary string Tiêu đề của lịch. có thể ghi
timeZone string Múi giờ của lịch. (Được định dạng dưới dạng tên trong Cơ sở dữ liệu múi giờ IANA, ví dụ: "Europe/Zurich".) Không bắt buộc. có thể ghi

Phương thức

xoá
Xoá lịch chính. Thao tác này sẽ xoá tất cả sự kiện liên kết với lịch chính của một tài khoản.
xóa
Xoá lịch phụ. Sử dụng calendars.clear để xoá tất cả sự kiện trên lịch chính.
get
Trả về siêu dữ liệu cho một lịch.
chèn
Tạo lịch phụ.

Người dùng đã xác thực cho yêu cầu sẽ trở thành chủ sở hữu dữ liệu của lịch mới.

patch
Cập nhật siêu dữ liệu cho một lịch. Phương thức này hỗ trợ ngữ nghĩa của bản vá. Xin lưu ý rằng mỗi yêu cầu vá sẽ tiêu thụ 3 đơn vị hạn mức; bạn nên sử dụng get, sau đó là update. Các giá trị 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. Nếu được chỉ định, các trường mảng 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 đó.
update
Cập nhật siêu dữ liệu cho một lịch.