Events: move

Przenosi wydarzenie do innego kalendarza, czyli zmienia organizatora wydarzenia. Pamiętaj, że można przenieść tylko liczbę wydarzeń (default). Nie można przenieść wydarzeń birthday, focusTime, fromGmail, outOfOffice i workingLocation. Wypróbuj lub zobacz przykład.

Żądanie

Żądanie HTTP

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/move

Parametry

Nazwa parametru Wartość Opis
Parametry ścieżki
calendarId string Identyfikator kalendarza źródłowego, w którym obecnie trwa wydarzenie.
eventId string Identyfikator zdarzenia.
Wymagane parametry zapytania
destination string Identyfikator kalendarza docelowego, do którego ma zostać przeniesione wydarzenie.
Opcjonalne parametry zapytania
sendNotifications boolean Rola wycofana. Zamiast tego użyj sendUpdates.

Określ, czy chcesz wysyłać powiadomienia o zmianie organizatora wydarzenia. Pamiętaj, że niektóre e-maile mogą być wysyłane nawet wtedy, gdy ustawisz wartość false. Wartość domyślna to false.
sendUpdates string Gości, którzy powinni otrzymać powiadomienia o zmianie organizatora wydarzenia.

Akceptowane wartości to:
  • all”: powiadomienia są wysyłane do wszystkich gości.
  • externalOnly”: powiadomienia są wysyłane tylko do gości, którzy nie korzystają z Kalendarza Google.
  • none”: nie zostaną wysłane żadne powiadomienia. W przypadku zadań migracji kalendarza rozważ użycie metody Events.import.

Autoryzacja

To żądanie wymaga autoryzacji z co najmniej jednym z tych zakresów:

Zakres
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events

Więcej informacji znajdziesz na stronie dotyczącej uwierzytelniania i autoryzacji.

Treść żądania

Nie podawaj treści żądania przy użyciu tej metody.

Odpowiedź

Jeśli operacja się uda, metoda zwróci zasób Zdarzenia w treści odpowiedzi.

Przykłady

Uwaga: dostępne dla tej metody przykłady kodu nie odzwierciedlają wszystkich obsługiwanych języków programowania. Listę obsługiwanych języków znajdziesz na stronie z bibliotekami klienta.

Java

Używa biblioteki klienta 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

Korzysta z biblioteki klienta Pythona.

# 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

Używa biblioteki klienta PHP.

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

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

Ruby

Używa biblioteki klienta Ruby.

result = client.move_event('primary', 'eventId', 'destinationCalendarId')
print result.updated

Wypróbuj

Użyj poniższego eksploratora interfejsów API, aby wywołać tę metodę na bieżących danych i wyświetlić odpowiedź.