Events: move

Przenosi wydarzenie do innego kalendarza, np. zmienia jego organizatora. Można przenieść tylko wydarzenia typu default. Nie można przenosić wydarzeń outOfOffice, focusTime i workingLocation. Wypróbuj 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 aktualnie odbywa się 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. 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 wartość 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 kalendarzy 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 uwierzytelniania i autoryzacji.

Treść żądania

Nie podawaj treści żądania z tą metodą.

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

Korzysta z 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 dla języka 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

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