Events: move

Verschiebt einen Termin in einen anderen Kalender, d.h. ändert den Organisator des Termins. Nur default-Ereignisse können verschoben werden. outOfOffice-, focusTime-, workingLocation- und fromGmail-Ereignisse können nicht verschoben werden. Probieren Sie es gleich aus oder sehen Sie sich ein Beispiel an.

Anfragen

HTTP-Anfrage

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

Parameter

Parametername Wert Beschreibung
Pfadparameter
calendarId string Kalender-ID des Quellkalenders, in dem der Termin derzeit stattfindet.
eventId string Ereignis-ID.
Erforderliche Abfrageparameter
destination string Kalender-ID des Zielkalenders, in den der Termin verschoben werden soll.
Optionale Abfrageparameter
sendNotifications boolean Veraltet. Verwenden Sie stattdessen sendUpdates.

Gibt an, ob Benachrichtigungen über die Änderung des Organisators des Termins gesendet werden sollen. Beachten Sie, dass einige E-Mails möglicherweise trotzdem gesendet werden, wenn Sie den Wert auf false festlegen. Der Standardwert ist false.
sendUpdates string Gäste, die über die Änderung des Organisators des Termins benachrichtigt werden sollen.

Zulässige Werte sind:
  • „all“: Benachrichtigungen werden an alle Gäste gesendet.
  • „externalOnly“: Benachrichtigungen werden nur an Gäste gesendet, die Google Kalender nicht verwenden.
  • none: Es werden keine Benachrichtigungen gesendet. Für Kalendermigrationsaufgaben sollten Sie stattdessen die Methode Events.import verwenden.

Autorisierung

Für diese Anfrage ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:

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

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Mit dieser Methode keinen Anfragetext bereitstellen.

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Ereignisressource im Antworttext zurückgegeben.

Beispiele

Hinweis: Bei den für diese Methode verfügbaren Codebeispielen sind nicht alle unterstützten Programmiersprachen vertreten. Eine Liste der unterstützten Sprachen finden Sie auf der Seite für Clientbibliotheken.

Java

Verwendet die Java-Clientbibliothek.

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

Verwendet die Python-Clientbibliothek.

# 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

Verwendet die PHP-Clientbibliothek.

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

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

Ruby

Verwendet die Ruby-Clientbibliothek.

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

Jetzt testen

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.