Events: move

Di chuyển một sự kiện sang 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 default sự kiện; Bạn không thể di chuyển các sự kiện birthday, focusTime, fromGmail, outOfOfficeworkingLocation. 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.
Tham số truy vấn bắt buộc
destination string Giá trị nhận dạng lịch của lịch đích nơi sự kiện sẽ được chuyển đến.
Tham số truy vấn 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ề thay đổi của người tổ chức sự kiện hay không. Xin lưu ý rằng một số email có thể vẫn đượ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 mời sẽ nhận được thông báo về việc thay đổi người tổ chức sự kiện.

Các giá trị được chấp nhận là:
  • "all": Thông báo được gửi cho tất cả khách.
  • "externalOnly": Thông báo chỉ được gửi cho những khách không phải là khách là người dùng Lịch Google.
  • "none": Không có thông báo nào được gửi. Đối với các tác vụ di chuyển lịch, hãy cân nhắc sử dụng phương thức Events.import.

Ủy quyền

Yêu cầu này cần có sự 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

Đừ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 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();

// Move an event to another calendar
Event updatedEvent =
    service.events().move('primary', "eventId", "destinationCalendarId").execute();

System.out.println(updatedEvent.getUpdated());

Python

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

Dùng thư viện ứng dụng PHP.

$result = $service->events->move('primary', 'eventId', 'destinationCalendarId');

// Print the updated date.
echo $result->getUpdated();

Ruby

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.