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
    ]
  },
  "labelProperties": {
    "eventLabels": [
      {
        "id": string,
        "backgroundColor": string,
        "name": string
      }
    ]
  },
  "autoAcceptInvitations": boolean
}

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 đượ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.

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 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 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ị tắt hoặc bị xoá.

update

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