Di chuyển một sự kiện sang một lịch khác, tức là thay đổi người tổ chức sự kiện. Xin lưu ý rằng bạn chỉ có thể di chuyển các sự kiện default; không thể di chuyển các sự kiện birthday, focusTime, fromGmail, outOfOffice và workingLocation.
Thử ngay hoặc xem ví dụ.
Yêu cầu
Yêu cầu HTTP
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/move
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 của lịch nguồn nơi sự kiện hiện đang diễn ra. |
eventId |
string |
Giá trị nhận dạng sự kiện. |
| Thông số truy vấn bắt buộc | ||
destination |
string |
Giá trị nhận dạng lịch của lịch mục tiêu mà sự kiện sẽ được chuyển đến. |
| Thông số truy vấn 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ề việc thay đổi người tổ chức sự kiện hay không. 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 |
Khách cần nhận được thông báo về thay đổi của người tổ chức sự kiện.
Các giá trị được chấp nhận là:
|
Ủ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 |
Để 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
Không cung cấp nội dung yêu cầu bằng phương thức này.
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.
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
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();
// Move an event to another calendar
Event updatedEvent =
service.events().move('primary', "eventId", "destinationCalendarId").execute();
System.out.println(updatedEvent.getUpdated());
Python
Sử dụng thư viện ứng dụng Python.
# First retrieve the event from the API.
updated_event = service.events().move(
calendarId='primary', eventId='eventId',
destination='destinationCalendarId').execute()
# Print the updated date.
print updated_event['updated']
PHP
Sử dụng thư viện ứng dụng PHP.
$result = $service->events->move('primary', 'eventId', 'destinationCalendarId');
// Print the updated date.
echo $result->getUpdated();
Ruby
Sử dụng thư viện ứng dụng Ruby.
result = client.move_event('primary', 'eventId', 'destinationCalendarId')
print result.updated
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.