Cập nhật một sự kiện. Phương thức này không hỗ trợ ngữ nghĩa của bản vá và luôn cập nhật toàn bộ tài nguyên sự kiện. Để cập nhật một phần, hãy thực hiện get, sau đó là update bằng thẻ điện tử để đảm bảo tính nguyên tử.
Thử ngay hoặc xem ví dụ.
Yêu cầu
Yêu cầu HTTP
PUT https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId
Thông số
| Tên thông số | Giá trị | Nội dung 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 đ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. Một 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à 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 phần 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 các hội nghị mới bằng cách sử dụng trường createRequest củaconferenceData. Giá trị mặc định là 0.
Các giá trị được chấp nhận là từ 0 đến 1.
|
maxAttendees |
integer |
Số người tham dự tối đa có thể đưa vào phản hồi. Nếu có nhiều hơn số người tham dự đã chỉ định, chỉ có người tham gia đó được trả về. Không bắt buộc. |
sendNotifications |
boolean |
Không dùng nữa. Thay vào đó, vui lòng sử dụng sendUpdates. Liệu có gửi thông báo về thông tin cập nhật sự kiện hay không (ví dụ: thay đổi về 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ề việc cập nhật sự kiện (ví dụ: thay đổi tiêu đề, v.v.).
Các giá trị có thể chấp nhận là:
|
supportsAttachments |
boolean |
Liệu ứng dụng API đang 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 |
Để 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 tài nguyên Sự kiện với các thuộc tính sau:
| Tên tài sản | Giá trị | Nội dung mô tả | Ghi chú |
|---|---|---|---|
| Thuộc tính bắt buộc | |||
end |
nested object |
Thời gian kết thúc (không bao gồm) sự kiện. Đối với sự kiện định kỳ, đây là thời gian kết thúc của lần đầu tiên. | |
start |
nested object |
Thời gian bắt đầu (bao gồm) của sự kiện. Đối với sự kiện định kỳ, đây là thời gian bắt đầu của lần đầu tiên. | |
| Thuộc tính không bắt buộc | |||
anyoneCanAddSelf |
boolean |
Liệu bất kỳ ai cũng có thể mời chính mình tham gia sự kiện (không dùng nữa). Không bắt buộc. Giá trị mặc định là False. | có thể ghi |
attachments[].fileUrl |
string |
URL đến tệp đính kèm. Để thêm tệp đính kèm trên Google Drive, hãy sử dụng định dạng giống như trong thuộc tính Bắt buộc khi thêm tệp đính kèm. |
có thể ghi |
attendees[] |
list |
Người tham dự sự kiện. Xem hướng dẫn Sự kiện với người tham dự để biết thêm thông tin về cách lên lịch sự kiện với người dùng lịch khác. Tài khoản dịch vụ cần sử dụng tính năng uỷ quyền trên toàn miền để điền danh sách người tham dự. | có thể ghi |
attendees[].additionalGuests |
integer |
Số lượng khách bổ sung. Không bắt buộc. Giá trị mặc định là 0. | có thể ghi |
attendees[].comment |
string |
Nhận xét trong phản hồi của người tham dự. Không bắt buộc. | có thể ghi |
attendees[].displayName |
string |
Tên người tham dự, nếu có. Không bắt buộc. | có thể ghi |
attendees[].email |
string |
Địa chỉ email của người tham dự, nếu có. Trường này phải hiển thị khi thêm người tham dự. Đó phải là một địa chỉ email hợp lệ theo tiêu chuẩn RFC5322. Bắt buộc khi thêm người tham dự. |
có thể ghi |
attendees[].optional |
boolean |
Liệu đây có phải là người tham dự không bắt buộc hay không. Không bắt buộc. Giá trị mặc định là False. | có thể ghi |
attendees[].resource |
boolean |
Liệu người tham dự có phải là một tài nguyên hay không. Chỉ có thể đặt khi người tham dự được thêm vào sự kiện lần đầu tiên. Các lần sửa đổi tiếp theo sẽ bị bỏ qua. Không bắt buộc. Giá trị mặc định là False. | có thể ghi |
attendees[].responseStatus |
string |
Trạng thái phản hồi của người tham dự. Các giá trị có thể sử dụng là:
|
có thể ghi |
attendeesOmitted |
boolean |
Liệu người tham dự có bị bỏ qua trong nội dung trình bày của sự kiện hay không. Khi truy xuất một sự kiện, điều này có thể là do một quy định hạn chế do tham số truy vấn maxAttendee chỉ định. Khi cập nhật một sự kiện, bạn có thể sử dụng tính năng này để chỉ cập nhật câu trả lời của người tham gia. Không bắt buộc. Giá trị mặc định là False. |
có thể ghi |
colorId |
string |
Màu của sự kiện. Đây là mã nhận dạng tham chiếu đến một mục nhập trong phần event của định nghĩa về màu sắc (xem điểm cuối về màu sắc). Không bắt buộc. |
có thể ghi |
conferenceData |
nested object |
Thông tin liên quan đến hội nghị truyền hình, chẳng hạn như thông tin chi tiết về một hội nghị truyền hình trên Google Meet. Để tạo thông tin chi tiết về hội nghị truyền hình mới, hãy dùng trường createRequest. Để duy trì các thay đổi, hãy nhớ đặt tham số yêu cầu conferenceDataVersion thành 1 cho tất cả các yêu cầu sửa đổi sự kiện. |
có thể ghi |
description |
string |
Mô tả về sự kiện. Có thể chứa HTML. Không bắt buộc. | có thể ghi |
end.date |
date |
Ngày, ở định dạng "yyyy-mm-dd", nếu đây là sự kiện cả ngày. | có thể ghi |
end.dateTime |
datetime |
Thời gian, dưới dạng giá trị ngày-giờ kết hợp (được định dạng theo RFC3339). Bạn phải có chênh lệch múi giờ trừ phi múi giờ được chỉ định rõ trong timeZone. |
có thể ghi |
end.timeZone |
string |
Múi giờ mà thời gian được chỉ định. (Được định dạng dưới dạng tên Cơ sở dữ liệu múi giờ IANA, ví dụ: "Châu Âu/Zurich".) Đối với các sự kiện định kỳ, trường này là bắt buộc và chỉ định múi giờ mà việc lặp lại được mở rộng. Đối với các sự kiện đơn lẻ, trường này là không bắt buộc và cho biết múi giờ tuỳ chỉnh cho sự kiện bắt đầu/kết thúc. | có thể ghi |
extendedProperties.private |
object |
Những thuộc tính dành riêng cho bản sao của sự kiện xuất hiện trên lịch này. | có thể ghi |
extendedProperties.shared |
object |
Các thuộc tính được chia sẻ giữa các bản sao của sự kiện trên lịch của người tham dự khác. | có thể ghi |
focusTimeProperties |
nested object |
Dữ liệu sự kiện Thời gian cần tập trung. Được dùng nếu eventType là focusTime. |
có thể ghi |
gadget.display |
string |
Chế độ hiển thị của tiện ích. Không dùng nữa. Các giá trị có thể sử dụng là:
|
có thể ghi |
gadget.height |
integer |
Chiều cao của tiện ích tính bằng pixel. Chiều cao phải là số nguyên lớn hơn 0. Không bắt buộc. Không dùng nữa. | có thể ghi |
gadget.iconLink |
string |
URL biểu tượng của tiện ích. Lược đồ URL phải là HTTPS. Không dùng nữa. | có thể ghi |
gadget.link |
string |
URL của tiện ích. Lược đồ URL phải là HTTPS. Không dùng nữa. | có thể ghi |
gadget.preferences |
object |
Tùy chọn. | có thể ghi |
gadget.title |
string |
Tên tiện ích. Không dùng nữa. | có thể ghi |
gadget.type |
string |
Loại tiện ích. Không dùng nữa. | có thể ghi |
gadget.width |
integer |
Chiều rộng của tiện ích tính bằng pixel. Chiều rộng phải là một số nguyên lớn hơn 0. Không bắt buộc. Không dùng nữa. | có thể ghi |
guestsCanInviteOthers |
boolean |
Liệu người tham dự không phải người tổ chức có thể mời người khác tham gia sự kiện hay không. Không bắt buộc. Giá trị mặc định là True. | có thể ghi |
guestsCanModify |
boolean |
Liệu người tham dự không phải người tổ chức có thể sửa đổi sự kiện hay không. Không bắt buộc. Giá trị mặc định là False. | có thể ghi |
guestsCanSeeOtherGuests |
boolean |
Liệu người tham dự không phải là người tổ chức có thể biết những người tham dự sự kiện là ai hay không. Không bắt buộc. Giá trị mặc định là True. | có thể ghi |
location |
string |
Vị trí địa lý của sự kiện dưới dạng văn bản dạng tự do. Không bắt buộc. | có thể ghi |
originalStartTime.date |
date |
Ngày, ở định dạng "yyyy-mm-dd", nếu đây là sự kiện cả ngày. | có thể ghi |
originalStartTime.dateTime |
datetime |
Thời gian, dưới dạng giá trị ngày-giờ kết hợp (được định dạng theo RFC3339). Bạn phải có chênh lệch múi giờ trừ phi múi giờ được chỉ định rõ trong timeZone. |
có thể ghi |
originalStartTime.timeZone |
string |
Múi giờ mà thời gian được chỉ định. (Được định dạng dưới dạng tên Cơ sở dữ liệu múi giờ IANA, ví dụ: "Châu Âu/Zurich".) Đối với các sự kiện định kỳ, trường này là bắt buộc và chỉ định múi giờ mà việc lặp lại được mở rộng. Đối với các sự kiện đơn lẻ, trường này là không bắt buộc và cho biết múi giờ tuỳ chỉnh cho sự kiện bắt đầu/kết thúc. | có thể ghi |
outOfOfficeProperties |
nested object |
Dữ liệu về sự kiện không có mặt tại văn phòng. Được dùng nếu eventType là outOfOffice. |
có thể ghi |
recurrence[] |
list |
Danh sách các dòng RRULE, EXRULE, RDATE và EXDATE cho một sự kiện lặp lại, như được chỉ định trong RFC5545. Xin lưu ý rằng các dòng DTSTART và DTEND không được phép trong trường này; thời gian bắt đầu và kết thúc của sự kiện được chỉ định trong các trường start và end. Trường này bị bỏ qua đối với một sự kiện hoặc bản sao của sự kiện định kỳ. |
có thể ghi |
reminders.overrides[] |
list |
Nếu sự kiện không sử dụng lời nhắc mặc định, thao tác này sẽ liệt kê các lời nhắc dành riêng cho sự kiện hoặc nếu không được đặt, cho biết rằng không có lời nhắc nào được đặt cho sự kiện này. Số lượng lời nhắc ghi đè tối đa là 5. | có thể ghi |
reminders.overrides[].method |
string |
Phương thức mà lời nhắc này sử dụng. Các giá trị có thể sử dụng là:
Bắt buộc khi thêm lời nhắc. |
có thể ghi |
reminders.overrides[].minutes |
integer |
Số phút trước khi bắt đầu sự kiện khi lời nhắc sẽ kích hoạt. Các giá trị hợp lệ nằm trong khoảng từ 0 đến 40320 (4 tuần tính bằng phút). Bắt buộc khi thêm lời nhắc. |
có thể ghi |
reminders.useDefault |
boolean |
Liệu lời nhắc mặc định của lịch có áp dụng cho sự kiện hay không. | có thể ghi |
sequence |
integer |
Số thứ tự theo iLịch. | có thể ghi |
source.title |
string |
Tiêu đề của nguồn; ví dụ: tiêu đề của trang web hoặc chủ đề email. | có thể ghi |
source.url |
string |
URL của nguồn trỏ đến một tài nguyên. Lược đồ URL phải là HTTP hoặc HTTPS. | có thể ghi |
start.date |
date |
Ngày, ở định dạng "yyyy-mm-dd", nếu đây là sự kiện cả ngày. | có thể ghi |
start.dateTime |
datetime |
Thời gian, dưới dạng giá trị ngày-giờ kết hợp (được định dạng theo RFC3339). Bạn phải có chênh lệch múi giờ trừ phi múi giờ được chỉ định rõ trong timeZone. |
có thể ghi |
start.timeZone |
string |
Múi giờ mà thời gian được chỉ định. (Được định dạng dưới dạng tên Cơ sở dữ liệu múi giờ IANA, ví dụ: "Châu Âu/Zurich".) Đối với các sự kiện định kỳ, trường này là bắt buộc và chỉ định múi giờ mà việc lặp lại được mở rộng. Đối với các sự kiện đơn lẻ, trường này là không bắt buộc và cho biết múi giờ tuỳ chỉnh cho sự kiện bắt đầu/kết thúc. | có thể ghi |
status |
string |
Trạng thái của sự kiện. Không bắt buộc. Các giá trị có thể sử dụng là:
|
có thể ghi |
summary |
string |
Tiêu đề sự kiện. | có thể ghi |
transparency |
string |
Liệu sự kiện có chặn thời gian trên lịch hay không. Không bắt buộc. Các giá trị có thể sử dụng là:
|
có thể ghi |
visibility |
string |
Chế độ hiển thị của sự kiện. Không bắt buộc. Các giá trị có thể sử dụng là:
|
có thể ghi |
workingLocationProperties |
nested object |
Dữ liệu sự kiện về địa điểm làm việc. | có thể ghi |
workingLocationProperties.customLocation |
object |
Nếu có, chỉ định rằng người dùng đang làm việc ở một vị trí tuỳ chỉnh. | có thể ghi |
workingLocationProperties.customLocation.label |
string |
Nhãn bổ sung không bắt buộc để biết thêm thông tin. | có thể ghi |
workingLocationProperties.homeOffice |
any value |
Nếu có, chỉ định rằng người dùng đang làm việc tại nhà. | có thể ghi |
workingLocationProperties.officeLocation |
object |
Nếu có, chỉ định rằng người dùng đang làm việc tại văn phòng. | có thể ghi |
workingLocationProperties.officeLocation.buildingId |
string |
Mã nhận dạng toà nhà không bắt buộc. Mã này phải tham chiếu đến mã toà nhà trong cơ sở dữ liệu Tài nguyên của tổ chức. | có thể ghi |
workingLocationProperties.officeLocation.deskId |
string |
Giá trị nhận dạng không gian làm việc (không bắt buộc). | có thể ghi |
workingLocationProperties.officeLocation.floorId |
string |
Giá trị nhận dạng giá sàn không bắt buộc. | có thể ghi |
workingLocationProperties.officeLocation.floorSectionId |
string |
Mã nhận dạng phần tầng không bắt buộc. | có thể ghi |
workingLocationProperties.officeLocation.label |
string |
Tên văn phòng được hiển thị trong ứng dụng Lịch trên web và ứng dụng di động. Bạn nên tham chiếu tên toà nhà trong cơ sở dữ liệu Tài nguyên của tổ chức. | có thể ghi |
workingLocationProperties.type |
string |
Loại địa điểm làm việc. Các giá trị có thể sử dụng là:
Bắt buộc khi thêm thuộc tính địa điểm làm việ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 Sự kiện trong nội dung phản hồi.
Ví dụ
Lưu ý: Các đoạn mã mẫu của phương thức này không phải là ví dụ cho mọi ngôn ngữ lập trình được hỗ trợ (xem trang thông tin về các thư viện dùng cho ứng dụng để biết danh sách các ngôn ngữ được hỗ trợ).
Java
Sử dụng thư viện ứng dụng Java.
import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.Event;
// ...
// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
.setApplicationName("applicationName").build();
// Retrieve the event from the API
Event event = service.events().get("primary", "eventId").execute();
// Make a change
event.setSummary("Appointment at Somewhere");
// Update the event
Event updatedEvent = service.events().update("primary", event.getId(), event).execute();
System.out.println(updatedEvent.getUpdated());
Python
Dùng thư viện ứng dụng Python.
# First retrieve the event from the API. event = service.events().get(calendarId='primary', eventId='eventId').execute() event['summary'] = 'Appointment at Somewhere' updated_event = service.events().update(calendarId='primary', eventId=event['id'], body=event).execute() # Print the updated date. print updated_event['updated']
1.199
Sử dụng thư viện ứng dụng PHP.
// First retrieve the event from the API.
$event = $service->events->get('primary', 'eventId');
$event->setSummary('Appointment at Somewhere');
$updatedEvent = $service->events->update('primary', $event->getId(), $event);
// Print the updated date.
echo $updatedEvent->getUpdated();
Ruby
Sử dụng thư viện ứng dụng hồng ngọc.
event = client.get_event('primary', 'eventId')
event.summary = 'Appointment at Somewhere'
result = client.update_event('primary', event.id, event)
print result.updated
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 trực tiếp và xem phản hồi.