Events: move

Przenosi wydarzenie do innego kalendarza, czyli zmienia organizatora wydarzenia. Pamiętaj, że można przenosić tylko zdarzenia default. Zdarzenia birthday, focusTime, fromGmail, outOfOfficeworkingLocation nie można przenosić. Wypróbuj teraz 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 znajduje 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. Zamiast tego użyj parametru sendUpdates.

Czy 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:
  • 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ń związanych z migracją 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 Uwierzytelnianie i autoryzacja.

Treść żądania

W przypadku tej metody nie podawaj treści żądania.

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

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

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

Aby wywołać tę metodę na podstawie danych na żywo i zobaczyć odpowiedź, użyj narzędzia APIs Explorer.