Cập nhật siêu dữ liệu cho một lịch. Thử ngay.
Yêu cầu
Yêu cầu HTTP
PUT https://www.googleapis.com/calendar/v3/calendars/calendarIdThông số
| Tên thông số | Giá trị | Mô tả |
|---|---|---|
| Tham số đường dẫn | ||
calendarId |
string |
Mã nhận dạng lịch. Để truy xuất mã lịch, hãy gọi phương thức calendarList.list. Nếu bạn muốn truy cập vào lịch chính của người dùng hiện đang đăng nhập, hãy sử dụng từ khoá "primary".
|
Ủy quyền
Yêu cầu này cần có uỷ quyền với ít nhất một trong các phạm vi sau:
| Phạm vi |
|---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.app.created |
https://www.googleapis.com/auth/calendar.calendars |
Để biết thêm thông tin, hãy xem trang xác thực và uỷ quyền.
Nội dung yêu cầu
Trong nội dung yêu cầu, hãy cung cấp một Tài nguyên Lịch có các thuộc tính sau:
| Tên tài sản | Giá trị | Mô tả | Ghi chú |
|---|---|---|---|
| Thuộc tính 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 |
labelProperties |
nested object |
Các thuộc tính nhãn được xác định trên lịch này. Nếu được chỉ định, sẽ ghi đè các thuộc tính nhãn hiện có. Nếu bạn không chỉ định, các thuộc tính nhãn sẽ không thay đổi. | có thể ghi |
labelProperties.eventLabels[] |
list |
Nhãn sự kiện được xác định trên lịch này. Nếu có tham số này khi cập nhật lịch, thì tham số này sẽ thay thế các nhãn sự kiện hiện có. Mở rộng danh sách để thêm nhãn sự kiện mới và xoá các thực thể khỏi danh sách để xoá nhãn khỏi lịch. Mỗi lịch có thể có tối đa 200 nhãn. |
có thể ghi |
labelProperties.eventLabels[].backgroundColor |
string |
Màu nền của nhãn ở định dạng thập lục phân, chẳng hạn như "#039be5". Các sự kiện có nhãn này sẽ xuất hiện bằng màu này. Bắt buộc. |
có thể ghi |
labelProperties.eventLabels[].id |
string |
Mã của nhãn. Không bắt buộc khi chèn nhãn mới. Nếu bạn không cung cấp, hệ thống sẽ tạo một mã nhận dạng duy nhất. Bắt buộc khi cập nhật nhãn. Nếu được cung cấp, mã nhận dạng phải là duy nhất trong lịch và tuân theo định dạng UUID. |
có thể ghi |
labelProperties.eventLabels[].name |
string |
Tên của nhãn. Không bắt buộc. Nếu được cung cấp, trường này không được có quá 50 ký tự. |
có thể ghi |
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ản hồi
Nếu thành công, phương thức này sẽ trả về một tài nguyên Lịch trong nội dung phản hồi.
Hãy dùng thử!
Hãy sử dụng APIs Explorer bên dưới để gọi phương thức này trên dữ liệu thực và xem phản hồi.