Calendars
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Biểu diễn tài nguyên
{
"kind": "calendar#calendar",
"etag": etag,
"id": string,
"summary": string,
"description": string,
"location": string,
"timeZone": string,
"conferenceProperties": {
"allowedConferenceSolutionTypes": [
string
]
}
}
Tên tài sản |
Giá trị |
Mô tả |
Ghi chú |
conferenceProperties |
nested object |
Hội nghị các tài sản cho lịch này, ví dụ như 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ể có là: "eventHangout" "eventNamedHangout" "hangoutsMeet" Không bắt buộ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 dạng 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. (Định dạng thành tên của Cơ sở dữ liệu múi giờ IANA, ví dụ: "Châu Âu/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 được liên kết với lịch chính của tài khoản.
- xóa
- Xoá lịch phụ. Sử dụng calendar.clear để xoá tất cả sự kiện trên lịch chính.
- nhận
- Trả về siêu dữ liệu cho một lịch.
- chèn
- Tạo lịch phụ.
- 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á. Lưu ý rằng mỗi yêu cầu bản vá cần 3 đơn vị hạn mức; thích dùng
get
theo sau là update
. Các giá trị trường mà bạn chỉ định sẽ thay thế các giá trị hiện có. Những trường 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 siêu dữ liệu cho lịch.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[],[],null,["# Calendars\n\nA collection of all existing calendars. See also [Calendars vs CalendarList](/workspace/calendar/api/concepts/events-calendars#calendar_and_calendar_list).\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\n\u003cbr /\u003e\n\n```text\n{\n \"kind\": \"calendar#calendar\",\n \"etag\": etag,\n \"id\": string,\n \"summary\": string,\n \"description\": string,\n \"location\": string,\n \"timeZone\": string,\n \"conferenceProperties\": {\n \"allowedConferenceSolutionTypes\": [\n string\n ]\n }\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------------------------------------------------|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| `conferenceProperties` | `nested object` | Conferencing properties for this calendar, for example what types of conferences are allowed. | |\n| conferenceProperties.`allowedConferenceSolutionTypes[]` | `list` | The types of conference solutions that are supported for this calendar. The possible values are: - `\"eventHangout\"` - `\"eventNamedHangout\"` - `\"hangoutsMeet\"` Optional. \u003cbr /\u003e | |\n| `description` | `string` | Description of the calendar. Optional. | writable |\n| `etag` | `etag` | ETag of the resource. | |\n| `id` | `string` | Identifier of the calendar. To retrieve IDs call the [calendarList.list()](/calendar/v3/reference/calendarList/list) method. | |\n| `kind` | `string` | Type of the resource (\"`calendar#calendar`\"). | |\n| `location` | `string` | Geographic location of the calendar as free-form text. Optional. | writable |\n| `summary` | `string` | Title of the calendar. | writable |\n| `timeZone` | `string` | The time zone of the calendar. (Formatted as an IANA Time Zone Database name, e.g. \"Europe/Zurich\".) Optional. | writable |\n\nMethods\n-------\n\n[clear](/workspace/calendar/api/v3/reference/calendars/clear)\n: Clears a primary calendar. This operation deletes all events associated with the primary calendar of an account.\n\n[delete](/workspace/calendar/api/v3/reference/calendars/delete)\n: Deletes a secondary calendar. Use calendars.clear for clearing all events on primary calendars.\n\n[get](/workspace/calendar/api/v3/reference/calendars/get)\n: Returns metadata for a calendar.\n\n[insert](/workspace/calendar/api/v3/reference/calendars/insert)\n: Creates a secondary calendar.\n\n[patch](/workspace/calendar/api/v3/reference/calendars/patch)\n: Updates metadata for a calendar. This method supports patch semantics. Note that each patch request consumes three quota units; prefer using a `get` followed by an `update`. The field values you specify replace the existing values. Fields that you don't specify in the request remain unchanged. Array fields, if specified, overwrite the existing arrays; this discards any previous array elements.\n\n[update](/workspace/calendar/api/v3/reference/calendars/update)\n: Updates metadata for a calendar."]]