Calendars

Tập hợp tất cả lịch hiện có. Xem thêm bài viết Lịch so với CalendarList.

Để xem danh sách các phương thức cho tài nguyên này, hãy xem phần 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
    ]
  },
  "autoAcceptInvitations": boolean
}
Tên tài sản Giá trị Mô tả Ghi chú
autoAcceptInvitations boolean Liệu lịch này có tự động chấp nhận lời mời hay không. Chỉ hợp lệ đối với lịch tài nguyên.
conferenceProperties nested object Thuộc tính hội nghị cho lịch này, ví dụ: 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ể có 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ụ. Đây là thông tin chỉ cho phép đọc.
description string Nội dung mô tả lịch. Không bắt buộc. có thể ghi
etag etag ETag của tài nguyên.
id string Mã 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ạ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 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.
xoá
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 được 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.

vá
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 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 rồi đến 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 đó.
transferOwnership
Chuyển lịch phụ giữa những người dùng trong một tổ chức Google Workspace. Yêu cầu xác thực người dùng có đặc quyền quản trị viên đối với phần Quản lý lịch và một trong các phạm vi uỷ quyền sau:
  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.calendars
Trong yêu cầu, hãy đặt useAdminAccess thành true. Lịch phụ phải đang hoạt động thì mới có thể chuyển nhượng. Không hỗ trợ chuyển nhượng lịch đã bị vô hiệu hoá hoặc xoá.
cập nhật
Cập nhật siêu dữ liệu cho một lịch.