Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Wiederkehrende Termine

In diesem Dokument wird beschrieben, wie Sie mit wiederkehrenden Terminen und ihren Instanzen arbeiten.

Wiederkehrende Termine erstellen

Das Erstellen von wiederkehrenden Terminen ähnelt dem Erstellen eines regulären (einzelnen) Termins mit dem Feld recurrence der Ressource event.

Protokoll

POST /calendar/v3/calendars/primary/events
...

{
  "summary": "Appointment",
  "location": "Somewhere",
  "start": {
    "dateTime": "2011-06-03T10:00:00.000-07:00",
    "timeZone": "America/Los_Angeles"
  },
  "end": {
    "dateTime": "2011-06-03T10:25:00.000-07:00",
    "timeZone": "America/Los_Angeles"
  },
  "recurrence": [
    "RRULE:FREQ=WEEKLY;UNTIL=20110701T170000Z",
  ],
  "attendees": [
    {
      "email": "attendeeEmail",
      # Other attendee's data...
    },
    # ...
  ],
}

Java

Event event = new Event();

event.setSummary("Appointment");
event.setLocation("Somewhere");

ArrayList<EventAttendee> attendees = new ArrayList<EventAttendee>();
attendees.add(new EventAttendee().setEmail("attendeeEmail"));
// ...
event.setAttendees(attendees);

DateTime start = DateTime.parseRfc3339("2011-06-03T10:00:00.000-07:00");
DateTime end = DateTime.parseRfc3339("2011-06-03T10:25:00.000-07:00");
event.setStart(new EventDateTime().setDateTime(start).setTimeZone("America/Los_Angeles"));
event.setEnd(new EventDateTime().setDateTime(end).setTimeZone("America/Los_Angeles"));
event.setRecurrence(Arrays.asList("RRULE:FREQ=WEEKLY;UNTIL=20110701T170000Z"));

Event recurringEvent = service.events().insert("primary", event).execute();

System.out.println(createdEvent.getId());

.NET

Event event = new Event()
    {
      Summary = "Appointment",
      Location = "Somewhere",
      Start = new EventDateTime() {
          DateTime = new DateTime("2011-06-03T10:00:00.000:-07:00")
          TimeZone = "America/Los_Angeles"
      },
      End = new EventDateTime() {
          DateTime = new DateTime("2011-06-03T10:25:00.000:-07:00")
          TimeZone = "America/Los_Angeles"
      },
      Recurrence = new String[] {
          "RRULE:FREQ=WEEKLY;UNTIL=20110701T170000Z"
      },
      Attendees = new List<EventAttendee>()
          {
            new EventAttendee() { Email: "attendeeEmail" },
            // ...
          }
    };

Event recurringEvent = service.Events.Insert(event, "primary").Fetch();

Console.WriteLine(recurringEvent.Id);

Python

event = {
  'summary': 'Appointment',
  'location': 'Somewhere',
  'start': {
    'dateTime': '2011-06-03T10:00:00.000-07:00',
    'timeZone': 'America/Los_Angeles'
  },
  'end': {
    'dateTime': '2011-06-03T10:25:00.000-07:00',
    'timeZone': 'America/Los_Angeles'
  },
  'recurrence': [
    'RRULE:FREQ=WEEKLY;UNTIL=20110701T170000Z',
  ],
  'attendees': [
    {
      'email': 'attendeeEmail',
      # Other attendee's data...
    },
    # ...
  ],
}

recurring_event = service.events().insert(calendarId='primary', body=event).execute()

print recurring_event['id']

PHP

$event = new Google_Service_Calendar_Event();
$event->setSummary('Appointment');
$event->setLocation('Somewhere');
$start = new Google_Service_Calendar_EventDateTime();
$start->setDateTime('2011-06-03T10:00:00.000-07:00');
$start->setTimeZone('America/Los_Angeles');
$event->setStart($start);
$end = new Google_Service_Calendar_EventDateTime();
$end->setDateTime('2011-06-03T10:25:00.000-07:00');
$end->setTimeZone('America/Los_Angeles');
$event->setEnd($end);
$event->setRecurrence(array('RRULE:FREQ=WEEKLY;UNTIL=20110701T170000Z'));
$attendee1 = new Google_Service_Calendar_EventAttendee();
$attendee1->setEmail('attendeeEmail');
// ...
$attendees = array($attendee1,
                   // ...
                   );
$event->attendees = $attendees;
$recurringEvent = $service->events->insert('primary', $event);

echo $recurringEvent->getId();

Ruby

event = Google::Apis::CalendarV3::Event.new(
  summary: 'Appointment',
  location: 'Somewhere',
  start: {
    date_time: '2011-06-03T10:00:00.000-07:00',
    time_zone:  'America/Los_Angeles'
  },
  end: {
    date_time: '2011-06-03T10:25:00.000-07:00',
    time_zone: 'America/Los_Angeles'
  },
  recurrence: ['RRULE:FREQ=WEEKLY;UNTIL=20110701T170000Z']
  attendees: [
    {
      email: 'attendeeEmail'
    },
    #...
  ]
)
response = client.insert_event('primary', event)
print response.id

Auf Instanzen zugreifen

Wenn Sie alle Instanzen eines bestimmten wiederkehrenden Ereignisses aufrufen möchten, können Sie die Anfrage events.instances() verwenden.

Bei der Anfrage events.list() werden standardmäßig nur einzelne Termine, wiederkehrende Termine und Ausnahmen zurückgegeben. Instanzen, die keine Ausnahmen sind, werden nicht zurückgegeben. Wenn der Parameter singleEvents auf true gesetzt ist, werden alle einzelnen Instanzen im Ergebnis angezeigt, nicht aber die zugrunde liegenden wiederkehrenden Ereignisse. Wenn ein Nutzer mit Berechtigungen für die Verfügbarkeit events.list() abfragt, verhält es sich so, als ob singleEvent gleich true ist. Weitere Informationen zu ACL-Regeln finden Sie unter Acl.

Einzelne Instanzen ähneln einzelnen Ereignissen. Im Gegensatz zu ihren übergeordneten wiederkehrenden Terminen haben Instanzen das Feld recurrence nicht festgelegt.

Die folgenden Ereignisfelder sind spezifisch für Instanzen:

recurringEventId: Die ID des übergeordneten wiederkehrenden Ereignisses, zu dem diese Instanz gehört.
originalStartTime: Die Startzeit dieser Instanz gemäß den Wiederholungsdaten im übergeordneten wiederkehrenden Termin. Diese kann sich von der tatsächlichen start-Zeit unterscheiden, wenn die Instanz neu geplant wurde. Sie identifiziert die Instanz innerhalb der Reihe wiederkehrender Termine eindeutig, auch wenn die Instanz verschoben wurde.

Instanzen ändern oder löschen

Wenn Sie eine einzelne Instanz ändern (eine Ausnahme erstellen) möchten, müssen Clientanwendungen zuerst die Instanz abrufen und sie dann aktualisieren, indem sie eine autorisierte PUT-Anfrage mit aktualisierten Daten im Textkörper an die Bearbeitungs-URL der Instanz senden. Die URL hat das folgende Format:

https://www.googleapis.com/calendar/v3/calendars/calendarId/events/instanceId

Verwenden Sie anstelle von calendarId und instanceId die entsprechenden Werte.

Hinweis :Mit dem speziellen calendarId-Wert primary kann auf den primären Kalender des authentifizierten Nutzers verwiesen werden.

Bei Erfolg antwortet der Server mit dem HTTP-Statuscode „200 OK“ und der aktualisierten Instanz. Im folgenden Beispiel wird gezeigt, wie Sie eine Instanz eines wiederkehrenden Ereignisses abbrechen.