Events: move

Przenosi wydarzenie do innego kalendarza, tj. zmienia jego organizatora. Można przenieść tylko wydarzenia default. Nie można przenieść wydarzeń outOfOffice, focusTime, workingLocation i fromGmail. Wypróbuj teraz lub zobacz przykład.

Prośba

Żą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 odbywa się wydarzenie.
eventId string Identyfikator zdarzenia.
Wymagane parametry zapytania
destination string Identyfikator kalendarza docelowego, do którego wydarzenie ma zostać przeniesione.
Opcjonalne parametry zapytania
sendNotifications boolean Rola wycofana. Użyj funkcji sendUpdates.

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

Akceptowane wartości:
  • „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 są wysyłane żadne powiadomienia. W przypadku zadań migracji kalendarza rozważ użycie metody Events.import.

Upoważnienie

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 Uwierzytelnianie i autoryzacja.

Treść żądania

Nie podawaj treści żądania za pomocą tej metody.

Odpowiedź

Jeśli operacja się uda, metoda zwróci zasób zdarzeń 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

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

Wykorzystuje bibliotekę 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 eksploratora interfejsów API poniżej, aby wywołać tę metodę na aktywnych danych i zobaczyć odpowiedź.