Calendars

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

Để xem danh sách phương thức cho tài nguyên này, hãy xem phần cuối của 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
    ]
  },
  "labelProperties": {
    "eventLabels": [
      {
        "id": string,
        "backgroundColor": string,
        "name": string
      }
    ]
  },
  "autoAcceptInvitations": boolean,
  "workingHours": {
    "workingHoursEnabled": boolean,
    "availableTimes": [
      {
        "dayOfWeek": string,
        "periodStart": integer,
        "periodEnd": integer
      }
    ]
  }
}

Phương thức

clear

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.

insert

Tạo lịch phụ.

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

bản vá

Cập nhật siêu dữ liệu cho 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á lỗi sẽ tiêu tốn 3 đơn vị hạn mức; bạn nên sử dụng get, sau đó là update. Giá trị của trường mà bạn chỉ định sẽ thay thế giá trị hiện có. Những 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 đó.

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 của quản trị viên là 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. Không hỗ trợ chuyển lịch đã bị vô hiệu hoá hoặc bị xoá.

update

Cập nhật siêu dữ liệu cho lịch.