Cập nhật một sự kiện. Phương thức này hỗ trợ ngữ nghĩa bản vá. Xin lưu ý rằng mỗi yêu cầu bản 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 đó.
Hãy dùng thử ngay.
Yêu cầu
Yêu cầu HTTP
PATCH https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId
Thông số
| Tên thông số | Giá trị | Mô tả |
|---|---|---|
| Tham số đường dẫn | ||
calendarId |
string |
Giá trị 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".
|
eventId |
string |
Giá trị nhận dạng sự kiện. |
| Tham số truy vấn không bắt buộc | ||
alwaysIncludeEmail |
boolean |
Không dùng nữa và bị bỏ qua. Giá trị sẽ luôn được trả về trong trường email cho người tổ chức, người tạo và người tham dự, ngay cả khi không có địa chỉ email thực (tức là một giá trị được tạo, không hoạt động sẽ được cung cấp).
|
conferenceDataVersion |
integer |
Số phiên bản của dữ liệu hội nghị được ứng dụng API hỗ trợ. Phiên bản 0 giả định không hỗ trợ dữ liệu hội nghị và bỏ qua dữ liệu hội nghị trong nội dung của sự kiện. Phiên bản 1 cho phép hỗ trợ việc sao chép ConferenceData cũng như tạo hội nghị mới bằng cách sử dụng trường createRequest của conferenceData. Giá trị mặc định là 0.
Giá trị có thể chấp nhận là tất cả các số từ 0 đến 1.
|
eventLabelVersion |
integer |
Số phiên bản của tính năng nhãn sự kiện được ứng dụng API hỗ trợ. Phiên bản 0 giả định không hỗ trợ nhãn sự kiện và xử lý trường colorId để quản lý màu. Phiên bản 1 cho phép hỗ trợ nhãn sự kiện và xử lý eventLabelId trong nội dung của sự kiện. Trong trường hợp này, trường colorId sẽ bị bỏ qua. Giá trị mặc định là 0.
Giá trị có thể chấp nhận là tất cả các số từ 0 đến 1.
|
maxAttendees |
integer |
Số lượng người tham dự tối đa cần đưa vào phản hồi. Nếu có nhiều người tham dự hơn số lượng đã chỉ định, thì chỉ người tham gia mới được trả về. Không bắt buộc. |
sendNotifications |
boolean |
Không dùng nữa. Vui lòng sử dụng sendUpdates thay thế. Có gửi thông báo về nội dung cập nhật sự kiện hay không (ví dụ: thay đổi nội dung mô tả, v.v.). Xin lưu ý rằng một số email vẫn có thể được gửi ngay cả khi bạn đặt giá trị thành false. Giá trị mặc định là false.
|
sendUpdates |
string |
Những khách sẽ nhận được thông báo về nội dung cập nhật sự kiện (ví dụ: thay đổi tiêu đề, v.v.).
Các giá trị được chấp nhận là:
|
supportsAttachments |
boolean |
Ứng dụng API thực hiện thao tác có hỗ trợ tệp đính kèm sự kiện hay không. Không bắt buộc. Giá trị mặc định là False. |
Ủ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.events |
https://www.googleapis.com/auth/calendar.app.created |
https://www.googleapis.com/auth/calendar.events.owned |
Để 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 các phần có liên quan của tài nguyên Sự kiện theo các quy tắc về ngữ nghĩa bản vá.
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 Sự kiện trong nội dung phản hồi.
Hãy dùng thử!
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.