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 vá sẽ tiêu thụ 3 đơn vị hạn mức; ưu tiên sử dụng get theo sau là update. 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. 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 đó.
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ả |
|---|---|---|
| Thông 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 đã đăng nhập, hãy sử dụng từ khoá "primary".
|
eventId |
string |
Giá trị nhận dạng sự kiện. |
| Thông số truy vấn không bắt buộc | ||
alwaysIncludeEmail |
boolean |
Ngừng sử dụng và bị bỏ qua. Hệ thống sẽ luôn trả về một giá trị trong trường email cho người tổ chức, nhà sáng tạo và người tham dự, ngay cả khi không có địa chỉ email thực (tức là hệ thống sẽ cung cấp một giá trị được tạo và không hoạt động).
|
conferenceDataVersion |
integer |
Số phiên bản của dữ liệu hội nghị mà ứ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 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ừ 0 đến 1.
|
maxAttendees |
integer |
Số lượng người tham dự tối đa cần đưa vào nội dung phản hồi. Nếu có nhiều hơn số người tham dự được 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. 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 của sự kiện (ví dụ: thay đổi tên, v.v.).
Các giá trị được chấp nhận là:
|
supportsAttachments |
boolean |
Liệu ứ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 yêu cầu 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 phần nội dung yêu cầu, hãy cung cấp các phần liên quan của tài nguyên Sự kiện, theo quy tắc ngữ nghĩa củ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 phần nội dung phản hồi.
Hãy dùng thử!
Sử dụng Trình khám phá API bên dưới để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi.