Events

Die Calendar API bietet verschiedene Varianten von Terminressourcen. Weitere Informationen finden Sie im Hilfeartikel Termine.

Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.

Ressourcendarstellungen

{
  "kind": "calendar#event",
  "etag": etag,
  "id": string,
  "status": string,
  "htmlLink": string,
  "created": datetime,
  "updated": datetime,
  "summary": string,
  "description": string,
  "location": string,
  "colorId": string,
  "creator": {
    "id": string,
    "email": string,
    "displayName": string,
    "self": boolean
  },
  "organizer": {
    "id": string,
    "email": string,
    "displayName": string,
    "self": boolean
  },
  "start": {
    "date": date,
    "dateTime": datetime,
    "timeZone": string
  },
  "end": {
    "date": date,
    "dateTime": datetime,
    "timeZone": string
  },
  "endTimeUnspecified": boolean,
  "recurrence": [
    string
  ],
  "recurringEventId": string,
  "originalStartTime": {
    "date": date,
    "dateTime": datetime,
    "timeZone": string
  },
  "transparency": string,
  "visibility": string,
  "iCalUID": string,
  "sequence": integer,
  "attendees": [
    {
      "id": string,
      "email": string,
      "displayName": string,
      "organizer": boolean,
      "self": boolean,
      "resource": boolean,
      "optional": boolean,
      "responseStatus": string,
      "comment": string,
      "additionalGuests": integer
    }
  ],
  "attendeesOmitted": boolean,
  "extendedProperties": {
    "private": {
      (key): string
    },
    "shared": {
      (key): string
    }
  },
  "hangoutLink": string,
  "conferenceData": {
    "createRequest": {
      "requestId": string,
      "conferenceSolutionKey": {
        "type": string
      },
      "status": {
        "statusCode": string
      }
    },
    "entryPoints": [
      {
        "entryPointType": string,
        "uri": string,
        "label": string,
        "pin": string,
        "accessCode": string,
        "meetingCode": string,
        "passcode": string,
        "password": string
      }
    ],
    "conferenceSolution": {
      "key": {
        "type": string
      },
      "name": string,
      "iconUri": string
    },
    "conferenceId": string,
    "signature": string,
    "notes": string,
  },
  "gadget": {
    "type": string,
    "title": string,
    "link": string,
    "iconLink": string,
    "width": integer,
    "height": integer,
    "display": string,
    "preferences": {
      (key): string
    }
  },
  "anyoneCanAddSelf": boolean,
  "guestsCanInviteOthers": boolean,
  "guestsCanModify": boolean,
  "guestsCanSeeOtherGuests": boolean,
  "privateCopy": boolean,
  "locked": boolean,
  "reminders": {
    "useDefault": boolean,
    "overrides": [
      {
        "method": string,
        "minutes": integer
      }
    ]
  },
  "source": {
    "url": string,
    "title": string
  },
  "workingLocationProperties": {
    "type": string,
    "homeOffice": (value),
    "customLocation": {
      "label": string
    },
    "officeLocation": {
      "buildingId": string,
      "floorId": string,
      "floorSectionId": string,
      "deskId": string,
      "label": string
    }
  },
  "outOfOfficeProperties": {
    "autoDeclineMode": string,
    "declineMessage": string
  },
  "focusTimeProperties": {
    "autoDeclineMode": string,
    "declineMessage": string,
    "chatStatus": string
  },
  "attachments": [
    {
      "fileUrl": string,
      "title": string,
      "mimeType": string,
      "iconLink": string,
      "fileId": string
    }
  ],
  "eventType": string
}

Property-Name	Wert	Beschreibung	Hinweise
anyoneCanAddSelf	boolean	Ob sich jeder zu dem Termin selbst einladen kann (eingestellt). Optional. Die Standardeinstellung ist "False".	Bearbeitbar
attachments[]	list	Dateianhänge für den Termin Zum Ändern von Anhängen sollte der Anfrageparameter supportsAttachments auf true gesetzt werden. Pro Termin sind maximal 25 Anhänge zulässig.
attachments[].fileId	string	ID der angehängten Datei. Schreibgeschützt. Bei Google Drive-Dateien ist dies die ID des entsprechenden Files-Ressourceneintrags in der Drive API.
attachments[].fileUrl	string	URL-Link zum Anhang. Verwenden Sie beim Hinzufügen von Google Drive-Dateianhängen dasselbe Format wie im Attribut alternateLink der Ressource Files in der Drive API. Erforderlich, wenn Sie einen Anhang hinzufügen.	Bearbeitbar
attachments[].iconLink	string	URL-Link zum Symbol des Anhangs. Dieses Feld kann nur für benutzerdefinierte Anhänge von Drittanbietern geändert werden.
attachments[].mimeType	string	Internetmedientyp (MIME-Typ) des Anhangs.
attachments[].title	string	Titel des Anhangs.
attendeesOmitted	boolean	Gibt an, ob Teilnehmer möglicherweise aus der Termindarstellung ausgeschlossen wurden. Beim Abrufen eines Ereignisses kann dies an einer Einschränkung liegen, die durch den Abfrageparameter maxAttendee festgelegt wurde. Wenn Sie einen Termin aktualisieren, können Sie damit nur die Antwort des Teilnehmers aktualisieren. Optional. Die Standardeinstellung ist "False".	Bearbeitbar
attendees[]	list	Die Teilnehmer des Termins. Weitere Informationen zum Planen von Terminen mit anderen Kalendernutzern finden Sie im Leitfaden Termine mit Teilnehmern. Dienstkonten müssen eine domainweite Delegierung von Befugnissen verwenden, um die Teilnehmerliste zu füllen.	Bearbeitbar
attendees[].additionalGuests	integer	Anzahl der zusätzlichen Gäste. Optional. Der Standardwert ist 0.	Bearbeitbar
attendees[].comment	string	Kommentar zur Antwort des Teilnehmers. Optional.	Bearbeitbar
attendees[].displayName	string	Name des Gastes, falls verfügbar. Optional.	Bearbeitbar
attendees[].email	string	Die E-Mail-Adresse des Teilnehmers, falls verfügbar. Dieses Feld muss beim Hinzufügen eines Gasts vorhanden sein. Es muss sich um eine gültige E-Mail-Adresse gemäß RFC5322 handeln. Erforderlich beim Hinzufügen eines Teilnehmers.	Bearbeitbar
attendees[].id	string	Profil-ID des Teilnehmers, falls verfügbar.
attendees[].optional	boolean	Gibt an, ob dies ein optionaler Teilnehmer ist. Optional. Die Standardeinstellung ist "False".	Bearbeitbar
attendees[].organizer	boolean	Gibt an, ob der Gast der Organisator des Termins ist. Schreibgeschützt. Die Standardeinstellung ist "False".
attendees[].resource	boolean	Gibt an, ob der Gast eine Ressource ist. Dieser Wert kann nur festgelegt werden, wenn der Teilnehmer dem Termin zum ersten Mal hinzugefügt wird. Nachfolgende Änderungen werden ignoriert. Optional. Die Standardeinstellung ist "False".	Bearbeitbar
attendees[].responseStatus	string	Der Antwortstatus des Teilnehmers. Mögliche Werte sind: "needsAction": Der Teilnehmer hat nicht auf die Einladung reagiert (empfohlen für neue Termine). "declined": Der Teilnehmer hat die Einladung abgelehnt. "tentative": Der Teilnehmer hat die Einladung vorläufig angenommen. "accepted": Der Teilnehmer hat die Einladung angenommen. Achtung:Wenn Sie einen Termin mit den Werten declined, tentative oder accepted hinzufügen, sehen Teilnehmer, für die die Einstellung „Meinem Kalender Einladungen hinzufügen“ auf „Wenn ich auf E-Mail-Einladung antworte“ festgelegt ist, nur dann einen Termin in ihrem Kalender, wenn sie ihre Antwort auf die Einladung in der E-Mail-Einladung ändern.	Bearbeitbar
attendees[].self	boolean	Gibt an, ob dieser Eintrag den Kalender repräsentiert, in dem diese Kopie des Termins angezeigt wird. Schreibgeschützt. Die Standardeinstellung ist "False".
colorId	string	Die Farbe des Termins. Dies ist eine ID, die sich auf einen Eintrag im Abschnitt event der Farbdefinition bezieht (siehe Endpunkt für Farben). Optional.	Bearbeitbar
conferenceData	nested object	Konferenzbezogene Informationen, z. B. Details zu einer Google Meet-Konferenz Verwenden Sie das Feld createRequest, um neue Konferenzdetails zu erstellen. Damit die Änderungen erhalten bleiben, müssen Sie den Anfrageparameter conferenceDataVersion für alle Ereignisänderungsanfragen auf 1 setzen.	Bearbeitbar
conferenceData.conferenceId	string	ID der Konferenz. Kann von Entwicklern verwendet werden, um Konferenzen zu verfolgen, sollte Nutzern nicht angezeigt werden. Der ID-Wert wird für jeden Konferenzlösungstyp unterschiedlich gebildet: eventHangout: ID nicht festgelegt. Dieser Konferenztyp wurde eingestellt. eventNamedHangout: Die ID ist der Name des Hangouts. Dieser Konferenztyp wurde eingestellt. hangoutsMeet: Die ID ist der aus 10 Buchstaben bestehende Besprechungscode, z. B. aaa-bbbb-ccc. addOn: Die ID wird vom Drittanbieter definiert. Optional.
conferenceData.conferenceSolution	nested object	Die Konferenzlösung, z. B. Google Meet. Festlegung für eine Konferenz mit einer fehlgeschlagenen Erstellungsanfrage aufgehoben. Entweder conferenceSolution und mindestens ein entryPoint oder createRequest ist erforderlich.
conferenceData.conferenceSolution.iconUri	string	Das für den Nutzer sichtbare Symbol für diese Lösung.
conferenceData.conferenceSolution.key	nested object	Der Schlüssel, mit dem die Konferenzlösung für diese Veranstaltung eindeutig identifiziert werden kann.
conferenceData.conferenceSolution.key.type	string	Der Lösungstyp für Konferenzen. Wenn ein Client auf einen unbekannten oder leeren Typ stößt, sollte er trotzdem die Einstiegspunkte anzeigen können. Sie sollte jedoch keine Änderungen zulassen. Die möglichen Werte sind: "eventHangout" für Hangouts für Privatnutzer (eingestellt; bei bestehenden Terminen wird möglicherweise dieser Konferenzlösungstyp angezeigt, aber es können keine neuen Konferenzen erstellt werden) "eventNamedHangout" für Nutzer des klassischen Hangouts für Google Workspace-Nutzer (eingestellt; bei bestehenden Terminen wird möglicherweise dieser Konferenzlösungstyp angezeigt, aber es können keine neuen Konferenzen erstellt werden) "hangoutsMeet" für Google Meet (http://meet.google.com) "addOn" für Konferenzanbieter von Drittanbietern
conferenceData.conferenceSolution.name	string	Der für den Nutzer sichtbare Name dieser Lösung. Nicht lokalisiert.
conferenceData.createRequest	nested object	Eine Anfrage zum Erstellen einer neuen Konferenz und zum Anhängen an den Termin. Die Daten werden asynchron generiert. Im Feld status können Sie sehen, ob die Daten vorhanden sind. Entweder conferenceSolution und mindestens ein entryPoint oder createRequest ist erforderlich.
conferenceData.createRequest.conferenceSolutionKey	nested object	Die Konferenzlösung, z. B. Hangouts oder Google Meet.
conferenceData.createRequest.conferenceSolutionKey.type	string	Der Lösungstyp für Konferenzen. Wenn ein Client auf einen unbekannten oder leeren Typ stößt, sollte er trotzdem die Einstiegspunkte anzeigen können. Sie sollte jedoch keine Änderungen zulassen. Die möglichen Werte sind: "eventHangout" für Hangouts für Privatnutzer (eingestellt; bei bestehenden Terminen wird möglicherweise dieser Konferenzlösungstyp angezeigt, aber es können keine neuen Konferenzen erstellt werden) "eventNamedHangout" für Nutzer des klassischen Hangouts für Google Workspace-Nutzer (eingestellt; bei bestehenden Terminen wird möglicherweise dieser Konferenzlösungstyp angezeigt, aber es können keine neuen Konferenzen erstellt werden) "hangoutsMeet" für Google Meet (http://meet.google.com) "addOn" für Konferenzanbieter von Drittanbietern
conferenceData.createRequest.requestId	string	Die vom Client generierte eindeutige ID für diese Anfrage. Clients sollten diese ID für jede neue Anfrage neu generieren. Wenn die angegebene ID mit der für die vorherige Anfrage identisch ist, wird die Anfrage ignoriert.
conferenceData.createRequest.status	nested object	Der Status der Anfrage zum Erstellen einer Konferenz.
conferenceData.createRequest.status.statusCode	string	Der aktuelle Status der Anfrage zum Erstellen einer Konferenz. Schreibgeschützt. Die möglichen Werte sind: "pending": Die Anfrage zum Erstellen einer Konferenz wird noch verarbeitet. "success": Die Anfrage zum Erstellen der Konferenz war erfolgreich. Die Einstiegspunkte werden ausgefüllt. "failure": Die Anfrage zum Erstellen der Konferenz ist fehlgeschlagen. Es gibt keine Einstiegspunkte.
conferenceData.entryPoints[]	list	Informationen zu einzelnen Konferenzeinstiegspunkten, z. B. URLs oder Telefonnummern. Sie müssen alle zur selben Konferenz gehören. Entweder conferenceSolution und mindestens ein entryPoint oder createRequest ist erforderlich.
conferenceData.entryPoints[].accessCode	string	Der Zugriffscode für den Zugriff auf die Konferenz. Die maximale Länge beträgt 128 Zeichen. Füllen Sie beim Erstellen neuer Konferenzdaten nur die Felder {meetingCode, accessCode, passcode, password, pin} aus, die der Terminologie des Konferenzanbieters entsprechen. Es sollten nur die ausgefüllten Felder angezeigt werden. Optional.
conferenceData.entryPoints[].entryPointType	string	Der Typ des Konferenzeinstiegspunkts. Folgende Werte sind möglich: "video": Über HTTP an einer Konferenz teilnehmen Eine Konferenz kann keinen oder einen video-Einstiegspunkt haben. "phone": Durch Wählen einer Telefonnummer an einer Konferenz teilnehmen. Eine Konferenz kann keinen oder mehrere phone-Einstiegspunkte haben. "sip": Über SIP an einer Konferenz teilnehmen Eine Konferenz kann keinen oder einen sip-Einstiegspunkt haben. "more": weitere Anleitung zur Teilnahme an einer Konferenz, z. B. zusätzliche Telefonnummern Eine Konferenz kann keinen oder einen more-Einstiegspunkt haben. Eine Konferenz, die nur einen more-Einstiegspunkt hat, ist keine gültige Konferenz.
conferenceData.entryPoints[].label	string	Das Label für den URI. Sichtbar für Endnutzer Nicht lokalisiert. Die maximale Länge beträgt 512 Zeichen. Beispiele: Für video: meet.google.com/aaa-bbbb-ccc für phone: [phone] für sip: [e-mail] Für more: sollte nicht ausgefüllt werden Optional.
conferenceData.entryPoints[].meetingCode	string	Der Besprechungscode für die Teilnahme an der Konferenz. Die maximale Länge beträgt 128 Zeichen. Füllen Sie beim Erstellen neuer Konferenzdaten nur die Felder {meetingCode, accessCode, passcode, password, pin} aus, die der Terminologie des Konferenzanbieters entsprechen. Es sollten nur die ausgefüllten Felder angezeigt werden. Optional.
conferenceData.entryPoints[].passcode	string	Der Sicherheitscode für die Teilnahme an der Konferenz. Die maximale Länge beträgt 128 Zeichen. Füllen Sie beim Erstellen neuer Konferenzdaten nur die Felder {meetingCode, accessCode, passcode, password, pin} aus, die der Terminologie des Konferenzanbieters entsprechen. Es sollten nur die ausgefüllten Felder angezeigt werden.
conferenceData.entryPoints[].password	string	Das Passwort für den Zugriff auf die Konferenz. Die maximale Länge beträgt 128 Zeichen. Füllen Sie beim Erstellen neuer Konferenzdaten nur die Felder {meetingCode, accessCode, passcode, password, pin} aus, die der Terminologie des Konferenzanbieters entsprechen. Es sollten nur die ausgefüllten Felder angezeigt werden. Optional.
conferenceData.entryPoints[].pin	string	Die PIN für den Zugriff auf die Konferenz. Die maximale Länge beträgt 128 Zeichen. Füllen Sie beim Erstellen neuer Konferenzdaten nur die Felder {meetingCode, accessCode, passcode, password, pin} aus, die der Terminologie des Konferenzanbieters entsprechen. Es sollten nur die ausgefüllten Felder angezeigt werden. Optional.
conferenceData.entryPoints[].uri	string	Der URI des Einstiegspunkts. Die maximale Länge beträgt 1.300 Zeichen. Format: für video, http: oder https: ist erforderlich. Für phone ist das Schema tel: erforderlich. Der URI sollte die gesamte Wählfolge enthalten (z.B. tel:[phone],,,123456789;1234). Für sip ist das Schema „sip:“ erforderlich, z.B. sip:[e-mail]. für more, http: oder https: ist erforderlich.
conferenceData.notes	string	Zusätzliche Hinweise (z. B. Anweisungen des Domainadministrators, rechtliche Hinweise), die dem Nutzer angezeigt werden sollen. Kann HTML enthalten. Die maximale Länge beträgt 2.048 Zeichen. Optional.
conferenceData.signature	string	Die Signatur der Konferenzdaten. Wird serverseitig generiert. Festlegung für eine Konferenz mit einer fehlgeschlagenen Erstellungsanfrage aufgehoben. Optional für eine Konferenz mit einer ausstehenden Anfrage zum Erstellen.
created	datetime	Erstellungszeit des Ereignisses (als RFC3339-Zeitstempel) Schreibgeschützt.
creator	object	Der Ersteller des Ereignisses Schreibgeschützt.
creator.displayName	string	Der Name des Creators, falls verfügbar.
creator.email	string	Die E-Mail-Adresse des Erstellers, falls verfügbar.
creator.id	string	Die Profil-ID des Erstellers, falls verfügbar.
creator.self	boolean	Gibt an, ob der Ersteller dem Kalender entspricht, in dem diese Kopie des Termins angezeigt wird. Schreibgeschützt. Die Standardeinstellung ist "False".
description	string	Beschreibung der Veranstaltung. Kann HTML enthalten. Optional.	Bearbeitbar
end	nested object	Die (exklusive) Endzeit des Ereignisses. Bei einem wiederkehrenden Termin ist dies das Ende des ersten Termins.
end.date	date	Das Datum im Format "jjjj-mm-tt", wenn es sich um einen ganztägigen Termin handelt.	Bearbeitbar
end.dateTime	datetime	Die Uhrzeit als kombinierter Datum-Uhrzeit-Wert (gemäß RFC3339 formatiert). Ein Zeitzonenversatz ist erforderlich, sofern in timeZone nicht explizit eine Zeitzone angegeben ist.	Bearbeitbar
end.timeZone	string	Die Zeitzone, in der die Zeit angegeben ist. (Formatiert als Name der IANA-Zeitzonendatenbank, z.B. „Europa/Zürich“.) Bei wiederkehrenden Terminen ist dieses Feld erforderlich. Es gibt die Zeitzone an, in der die wiederkehrende Termine angezeigt werden. Bei einzelnen Ereignissen ist dieses Feld optional und gibt eine benutzerdefinierte Zeitzone für den Beginn und das Ende des Ereignisses an.	Bearbeitbar
endTimeUnspecified	boolean	Gibt an, ob die Endzeit nicht angegeben ist. Aus Kompatibilitätsgründen wird trotzdem eine Endzeit angegeben, auch wenn dieses Attribut auf „True“ gesetzt ist. Die Standardeinstellung ist "False".
etag	etag	Das ETag der Ressource.
eventType	string	Spezifischer Ereignistyp. Dies kann nach dem Erstellen des Ereignisses nicht mehr geändert werden. Mögliche Werte sind: "default": ein normales Ereignis oder kein näher spezifizierter Wert „outOfOffice“: ein Außer-Haus-Termin. „focusTime“: ein Fokuszeit-Ereignis. „workingLocation“: ein Termin am Arbeitsort. "fromGmail": ein Termin aus Gmail. Dieser Ereignistyp kann nicht erstellt werden.	Bearbeitbar
extendedProperties	object	Erweiterte Eigenschaften des Ereignisses.
extendedProperties.private	object	Eigenschaften, die für die Kopie des in diesem Kalender angezeigten Termins privat sind.	Bearbeitbar
extendedProperties.private.(key)	string	Der Name der privaten Property und der entsprechende Wert.
extendedProperties.shared	object	Eigenschaften, die für Kopien des Termins in den Kalendern anderer Teilnehmer freigegeben sind.	Bearbeitbar
extendedProperties.shared.(key)	string	Der Name der gemeinsam genutzten Property und der entsprechende Wert.
focusTimeProperties	nested object	Fokuszeit-Ereignisdaten. Wird verwendet, wenn eventType gleich focusTime ist.	Bearbeitbar
focusTimeProperties.autoDeclineMode	string	Ob Besprechungseinladungen mit Fokuszeit-Terminen abgelehnt werden sollen. Gültige Werte sind declineNone, d. h., keine Besprechungseinladungen werden abgelehnt, declineAllConflictingInvitations, d. h., alle in Konflikt stehenden Besprechungseinladungen, die mit dem Termin in Konflikt stehen, werden abgelehnt. declineOnlyNewConflictingInvitations bedeutet, dass nur neue in Konflikt stehende Besprechungseinladungen abgelehnt werden, die während des Fokuszeit-Termins eingehen.
focusTimeProperties.chatStatus	string	Der Status zum Markieren des Nutzers in Google Chat und ähnlichen Produkten. Dies kann available oder doNotDisturb sein.
focusTimeProperties.declineMessage	string	Antwortnachricht, die festgelegt wird, wenn ein bestehender Termin oder eine neue Einladung von Google Kalender automatisch abgelehnt wird.
gadget	object	Ein Gadgets, das dieses Ereignis verlängert. Gadgets wurden eingestellt. Diese Struktur wird stattdessen nur zum Zurückgeben von Metadaten von Geburtstagskalendern verwendet.
gadget.display	string	Der Anzeigemodus des Gadgets. Veraltet. Mögliche Werte sind: "icon": Das Gadget wird neben dem Titel des Termins in der Kalenderansicht angezeigt. "chip": Das Gadgets wird angezeigt, wenn auf das Ereignis geklickt wird.	Bearbeitbar
gadget.height	integer	Die Höhe des Gadgets in Pixeln. Die Höhe muss eine Ganzzahl größer als 0 sein. Optional. Veraltet.	Bearbeitbar
gadget.iconLink	string	Die Symbol-URL des Gadgets. Das URL-Schema muss HTTPS sein. Veraltet.	Bearbeitbar
gadget.link	string	Die URL des Gadgets. Das URL-Schema muss HTTPS sein. Veraltet.	Bearbeitbar
gadget.preferences	object	Einstellungen.	Bearbeitbar
gadget.preferences.(key)	string	Der Name der Einstellung und der entsprechende Wert.
gadget.title	string	Der Titel des Gadgets. Veraltet.	Bearbeitbar
gadget.type	string	Der Typ des Gadgets. Veraltet.	Bearbeitbar
gadget.width	integer	Die Breite des Gadgets in Pixeln. Die Breite muss eine Ganzzahl größer als 0 sein. Optional. Veraltet.	Bearbeitbar
guestsCanInviteOthers	boolean	Gibt an, ob andere Teilnehmer als der Organisator andere zu dem Termin einladen können. Optional. Der Standardwert ist „True“.	Bearbeitbar
guestsCanModify	boolean	Gibt an, ob andere Teilnehmer als der Organisator den Termin ändern können. Optional. Die Standardeinstellung ist "False".	Bearbeitbar
guestsCanSeeOtherGuests	boolean	Gibt an, ob andere Teilnehmer als der Organisator sehen können, wer die Teilnehmer des Termins sind. Optional. Der Standardwert ist „True“.	Bearbeitbar
hangoutLink	string	Ein absoluter Link zum Google Hangout, der mit diesem Ereignis verknüpft ist. Schreibgeschützt.
htmlLink	string	Ein absoluter Link zu diesem Termin in der Weboberfläche von Google Kalender. Schreibgeschützt.
iCalUID	string	Eindeutige Ereignis-ID gemäß RFC5545. Er wird verwendet, um Termine in allen Kalendersystemen eindeutig zu identifizieren, und muss beim Importieren von Terminen über die import-Methode bereitgestellt werden. Beachten Sie, dass iCalUID und id nicht identisch sind und nur eines davon beim Erstellen des Ereignisses angegeben werden sollte. Ein Unterschied in der Semantik besteht darin, dass bei wiederkehrenden Terminen alle Vorkommen eines Termins unterschiedliche ids haben, aber alle dieselbe iCalUID haben. Wenn Sie ein Ereignis mit dem zugehörigen iCalUID abrufen möchten, rufen Sie die events.list-Methode mit dem Parameter iCalUID auf. Wenn Sie ein Ereignis mithilfe der zugehörigen id abrufen möchten, rufen Sie die Methode events.get auf.
id	string	Intransparente ID des Ereignisses. Wenn Sie neue einzelne oder wiederkehrende Termine erstellen, können Sie deren IDs angeben. Angegebene IDs müssen den folgenden Regeln entsprechen: In der ID sind die in base32hex-Codierung zulässigen Zeichen zulässig, d. h. die Kleinbuchstaben a–v und die Ziffern 0–9, siehe Abschnitt 3.1.2 in RFC2938. Die ID muss zwischen 5 und 1.024 Zeichen lang sein Die ID muss im Kalender eindeutig sein Da das System global verteilt ist, können wir nicht garantieren, dass ID-Kollisionen bei der Ereigniserstellung erkannt werden. Um das Risiko von Kollisionen zu minimieren, empfehlen wir die Verwendung eines etablierten UUID-Algorithmus, wie z. B. der in RFC4122 beschriebene Algorithmus. Wenn Sie keine ID angeben, wird sie automatisch vom Server generiert. Beachten Sie, dass icalUID und id nicht identisch sind und nur eines davon beim Erstellen des Ereignisses angegeben werden sollte. Ein Unterschied in der Semantik besteht darin, dass bei wiederkehrenden Terminen alle Vorkommen eines Termins unterschiedliche ids haben, aber alle dieselbe icalUID haben.	Bearbeitbar
kind	string	Typ der Ressource („calendar#event“)
location	string	Geografischer Standort des Ereignisses als Freitext. Optional.	Bearbeitbar
locked	boolean	Ob es sich um eine gesperrte Terminkopie handelt, bei der keine Änderungen an den Hauptereignisfeldern „Zusammenfassung“, „Beschreibung“, „Ort“, „Start“, „Ende“ und „Wiederholung“ vorgenommen werden können. Die Standardeinstellung ist "False". Schreibgeschützt.
organizer	object	Der Organisator des Termins. Wenn der Organisator auch ein Gast ist, wird dies mit einem separaten Eintrag in attendees angezeigt, bei dem das Feld organizer auf „True“ gesetzt ist. Verwenden Sie den Vorgang move, um den Organisator zu ändern. Schreibgeschützt, außer beim Importieren eines Termins	Bearbeitbar
organizer.displayName	string	Der Name des Organisators, falls verfügbar.	Bearbeitbar
organizer.email	string	Die E-Mail-Adresse des Organisators, falls verfügbar. Es muss sich um eine gültige E-Mail-Adresse gemäß RFC5322 handeln.	Bearbeitbar
organizer.id	string	Profil-ID des Organisators, falls verfügbar.
organizer.self	boolean	Gibt an, ob der Organisator dem Kalender entspricht, in dem diese Kopie des Termins angezeigt wird. Schreibgeschützt. Die Standardeinstellung ist "False".
originalStartTime	nested object	Bei einem wiederkehrenden Termin ist dies der Zeitpunkt, zu dem dieser Termin gemäß den Wiederholungsdaten des wiederkehrenden Termins beginnen würde. Dieser wird durch die Zeichenfolge "wiederkehrende Ereignis-ID" angegeben. Es identifiziert die Instanz innerhalb der Serie mit wiederkehrenden Terminen eindeutig, selbst wenn die Instanz an einen anderen Zeitpunkt verschoben wurde. Nicht veränderbar.
originalStartTime.date	date	Das Datum im Format "jjjj-mm-tt", wenn es sich um einen ganztägigen Termin handelt.	Bearbeitbar
originalStartTime.dateTime	datetime	Die Uhrzeit als kombinierter Datum-Uhrzeit-Wert (gemäß RFC3339 formatiert). Ein Zeitzonenversatz ist erforderlich, sofern in timeZone nicht explizit eine Zeitzone angegeben ist.	Bearbeitbar
originalStartTime.timeZone	string	Die Zeitzone, in der die Zeit angegeben ist. (Formatiert als Name der IANA-Zeitzonendatenbank, z.B. „Europa/Zürich“.) Bei wiederkehrenden Terminen ist dieses Feld erforderlich. Es gibt die Zeitzone an, in der die wiederkehrende Termine angezeigt werden. Bei einzelnen Ereignissen ist dieses Feld optional und gibt eine benutzerdefinierte Zeitzone für den Beginn und das Ende des Ereignisses an.	Bearbeitbar
outOfOfficeProperties	nested object	Daten zu Außer-Haus-Terminen. Wird verwendet, wenn eventType gleich outOfOffice ist.	Bearbeitbar
outOfOfficeProperties.autoDeclineMode	string	Ob Besprechungseinladungen mit sich überschneidenden Außer-Haus-Terminen abgelehnt werden sollen. Gültige Werte sind declineNone, d. h., keine Besprechungseinladungen werden abgelehnt, declineAllConflictingInvitations, d. h., alle in Konflikt stehenden Besprechungseinladungen, die mit dem Termin in Konflikt stehen, werden abgelehnt. declineOnlyNewConflictingInvitations bedeutet, dass nur neue in Konflikt stehende Besprechungseinladungen abgelehnt werden, die während des Außer-Haus-Termins eingehen.
outOfOfficeProperties.declineMessage	string	Antwortnachricht, die festgelegt wird, wenn ein bestehender Termin oder eine neue Einladung von Google Kalender automatisch abgelehnt wird.
privateCopy	boolean	Wenn die Richtlinie auf „True“ gesetzt ist, ist die Ereignisweitergabe deaktiviert. Hinweis: Dies ist nicht dasselbe wie Eigenschaften für private Veranstaltungen. Optional. Nicht veränderbar. Die Standardeinstellung ist "False".
recurrence[]	list	Liste der Zeilen RRULE, EXRULE, RDATE und EXDATE für einen wiederkehrenden Termin gemäß RFC5545. Beachten Sie, dass die Zeilen DTSTART und DTEND in diesem Feld nicht zulässig sind. Beginn und Ende des Ereignisses werden in den Feldern start und end angegeben. Bei einzelnen Terminen oder wiederkehrenden Terminen wird dieses Feld weggelassen.	Bearbeitbar
recurringEventId	string	Bei einem wiederkehrenden Termin ist dies der id des wiederkehrenden Termins, zu dem dieser Termin gehört. Nicht veränderbar.
reminders	object	Informationen zu den Terminerinnerungen für den authentifizierten Nutzer. Hinweis: Wenn Sie Erinnerungen ändern, ändert sich nicht auch die Eigenschaft updated des einschließenden Termins.
reminders.overrides[]	list	Wenn für den Termin nicht die Standarderinnerungen verwendet werden, werden hier die Erinnerungen für den Termin aufgelistet. Sind keine Erinnerungen festgelegt, werden für diesen Termin keine Erinnerungen festgelegt. Die maximale Anzahl von Erinnerungen zum Überschreiben beträgt 5.	Bearbeitbar
reminders.overrides[].method	string	Die von dieser Erinnerung verwendete Methode. Mögliche Werte sind: „email“: Erinnerungen werden per E-Mail gesendet. „popup“: Erinnerungen werden über ein Pop-up-Fenster auf der Benutzeroberfläche gesendet. Erforderlich beim Hinzufügen einer Erinnerung.	Bearbeitbar
reminders.overrides[].minutes	integer	Anzahl der Minuten vor Beginn des Ereignisses, in denen die Erinnerung ausgelöst werden soll. Gültige Werte liegen zwischen 0 und 40.320 (4 Wochen in Minuten). Erforderlich beim Hinzufügen einer Erinnerung.	Bearbeitbar
reminders.useDefault	boolean	Gibt an, ob die Standarderinnerungen des Kalenders für den Termin gelten.	Bearbeitbar
sequence	integer	Sequenznummer gemäß iCalendar	Bearbeitbar
source	object	Quelle, über die das Ereignis erstellt wurde. Zum Beispiel eine Webseite, eine E-Mail-Nachricht oder ein Dokument, das durch eine URL mit HTTP- oder HTTPS-Schema erkennbar ist. Kann nur vom Ersteller des Ereignisses angesehen oder geändert werden.
source.title	string	Der Titel der Quelle, z. B. der Titel einer Webseite oder ein E-Mail-Betreff.	Bearbeitbar
source.url	string	URL der Quelle, die auf eine Ressource verweist. Das URL-Schema muss HTTP oder HTTPS sein.	Bearbeitbar
start	nested object	Die (einschließlich) Startzeit des Ereignisses. Bei einem wiederkehrenden Termin ist dies der Beginn des ersten Termins.
start.date	date	Das Datum im Format "jjjj-mm-tt", wenn es sich um einen ganztägigen Termin handelt.	Bearbeitbar
start.dateTime	datetime	Die Uhrzeit als kombinierter Datum-Uhrzeit-Wert (gemäß RFC3339 formatiert). Ein Zeitzonenversatz ist erforderlich, sofern in timeZone nicht explizit eine Zeitzone angegeben ist.	Bearbeitbar
start.timeZone	string	Die Zeitzone, in der die Zeit angegeben ist. (Formatiert als Name der IANA-Zeitzonendatenbank, z.B. „Europa/Zürich“.) Bei wiederkehrenden Terminen ist dieses Feld erforderlich. Es gibt die Zeitzone an, in der die wiederkehrende Termine angezeigt werden. Bei einzelnen Ereignissen ist dieses Feld optional und gibt eine benutzerdefinierte Zeitzone für den Beginn und das Ende des Ereignisses an.	Bearbeitbar
status	string	Status des Ereignisses. Optional. Mögliche Werte sind: „confirmed“: Das Ereignis wurde bestätigt. Dies ist der Standardstatus. „tentative“: Die Veranstaltung wurde vorläufig bestätigt. "cancelled": Der Termin wurde abgebrochen (gelöscht). Die Methode list gibt nur bei inkrementeller Synchronisierung abgebrochene Ereignisse zurück (wenn syncToken oder updatedMin angegeben sind) oder wenn das Flag showDeleted auf true gesetzt ist. Sie werden von der Methode get immer zurückgegeben. Der Status „Abgebrochen“ stellt je nach Ereignistyp zwei verschiedene Status dar: Abgesagte Ausnahmen eines nicht abgesagten wiederkehrenden Termins geben an, dass diese Instanz dem Nutzer nicht mehr angezeigt werden soll. Kunden sollten diese Ereignisse für die Lebensdauer des übergeordneten wiederkehrenden Ereignisses speichern. Bei abgebrochenen Ausnahmen enthalten nur die Werte für die Felder id, recurringEventId und originalStartTime garantiert automatisch ausgefüllt. Die anderen Felder sind möglicherweise leer. Alle anderen abgebrochenen Ereignisse stellen gelöschte Ereignisse dar. Kunden sollten ihre lokal synchronisierten Kopien entfernen. Solche abgesagten Ereignisse werden irgendwann nicht mehr angezeigt. Sie sind also nicht auf unbestimmte Zeit verfügbar. Bei gelöschten Ereignissen ist nur das Feld id automatisch ausgefüllt. Abgesagte Termine im Kalender des Organisators enthalten weiterhin Termindetails (Zusammenfassung, Ort usw.), damit sie wiederhergestellt werden können. Ebenso enthalten die Ereignisse, zu denen der Nutzer eingeladen wurde und die er manuell entfernt hat, weiterhin Details. Bei inkrementellen Synchronisierungsanfragen, bei denen showDeleted auf „false“ gesetzt ist, werden diese Details jedoch nicht zurückgegeben. Wenn sich der Organisator eines Termins ändert, z. B. durch den Vorgang move, und der ursprüngliche Organisator nicht in der Teilnehmerliste enthalten ist, wird ein abgesagter Termin beibehalten, bei dem nur das Feld id garantiert gefüllt wird.	Bearbeitbar
summary	string	Titel der Veranstaltung.	Bearbeitbar
transparency	string	Gibt an, ob der Termin die Zeit im Kalender blockiert. Optional. Mögliche Werte sind: „opaque“: Standardwert. Der Termin blockiert die Zeit im Kalender. Dies entspricht der Einstellung für Anzeigen als in der Kalender-Benutzeroberfläche auf Beschäftigt. „transparent“: Durch den Termin wird keine Zeit im Kalender blockiert. Dies entspricht der Einstellung Anzeigen als in der Kalender-Benutzeroberfläche auf Verfügbar.	Bearbeitbar
updated	datetime	Zeitpunkt der letzten Änderung der Hauptereignisdaten (als RFC3339-Zeitstempel) Durch das Aktualisieren von Terminerinnerungen ändert sich dies nicht. Schreibgeschützt.
visibility	string	Sichtbarkeit des Ereignisses. Optional. Mögliche Werte sind: „default“: Verwendet die Standardsichtbarkeit für Termine im Kalender. „Immer“ ist der Standardwert. "public": Der Termin ist öffentlich und die Termindetails sind für alle Leser des Kalenders sichtbar. "private": Der Termin ist privat und nur die Teilnehmer können die Termindetails sehen. „confidential“: Der Termin ist privat. Dieser Wert wird aus Kompatibilitätsgründen angegeben.	Bearbeitbar
workingLocationProperties	nested object	Ereignisdaten zum Arbeitsort.	Bearbeitbar
workingLocationProperties.customLocation	object	Falls vorhanden: Gibt an, dass der Nutzer von einem benutzerdefinierten Standort aus arbeitet.	Bearbeitbar
workingLocationProperties.customLocation.label	string	Ein optionales zusätzliches Label für zusätzliche Informationen.	Bearbeitbar
workingLocationProperties.homeOffice	any value	Falls vorhanden: Gibt an, dass der Nutzer zu Hause arbeitet.	Bearbeitbar
workingLocationProperties.officeLocation	object	Falls vorhanden: Gibt an, dass der Nutzer in einem Büro arbeitet.	Bearbeitbar
workingLocationProperties.officeLocation.buildingId	string	Eine optionale Gebäude-ID. Diese sollte auf eine Gebäude-ID in der Ressourcendatenbank der Organisation verweisen.	Bearbeitbar
workingLocationProperties.officeLocation.deskId	string	Eine optionale Desktop-ID.	Bearbeitbar
workingLocationProperties.officeLocation.floorId	string	Eine optionale Etagenkennzeichnung.	Bearbeitbar
workingLocationProperties.officeLocation.floorSectionId	string	Eine optionale Etagenabschnitts-ID.	Bearbeitbar
workingLocationProperties.officeLocation.label	string	Der Büroname, der in Google Kalender Web und Mobile-Clients angezeigt wird. Wir empfehlen, in der Ressourcendatenbank der Organisation auf einen Gebäudenamen zu verweisen.	Bearbeitbar
workingLocationProperties.type	string	Art des Arbeitsorts. Mögliche Werte sind: „homeOffice“: Der Nutzer arbeitet zu Hause. „officeLocation“: Der Nutzer arbeitet in einem Büro. „customLocation“: Der Nutzer arbeitet an einem benutzerdefinierten Standort. Alle Details werden in einem Unterfeld des angegebenen Namens angegeben. Dieses Feld kann jedoch fehlen, wenn es leer ist. Alle anderen Felder werden ignoriert. Erforderlich, wenn Eigenschaften des Arbeitsorts hinzugefügt werden.	Bearbeitbar

Methoden

delete

Löscht einen Termin.

get

Gibt einen Termin basierend auf seiner Google Kalender-ID zurück. Wenn Sie einen Termin anhand seiner iKalender-ID abrufen möchten, rufen Sie die events.list-Methode mit dem Parameter iCalUID auf.

import

Importiert einen Termin. Mit diesem Vorgang wird einem Kalender eine private Kopie eines vorhandenen Termins hinzugefügt. Nur Termine mit dem eventType-Wert default können importiert werden.

Eingestelltes Verhalten:Wenn ein Ereignis importiert wird, das nicht zu default gehört, wird sein Typ in default geändert und alle ereignisbasierten Eigenschaften, die es möglicherweise hat, werden entfernt.

insert

Erstellt ein Ereignis.

Instanzen

Gibt Instanzen des angegebenen wiederkehrenden Termins zurück.

list

Gibt Termine im angegebenen Kalender zurück.

verschieben

Verschieben eines Termins in einen anderen Kalender, d.h., der Organisator eines Termins wird geändert. Es können nur default-Ereignisse verschoben werden. outOfOffice-, focusTime-, workingLocation- und fromGmail-Ereignisse können nicht verschoben werden.

patch

Aktualisiert ein Ereignis. Diese Methode unterstützt die Patch-Semantik. Beachten Sie, dass jede Patchanfrage drei Kontingenteinheiten verbraucht. Bevorzugen Sie die Verwendung von get gefolgt von einem update. Die von Ihnen angegebenen Feldwerte ersetzen die vorhandenen Werte. Felder, die Sie nicht in der Anfrage angeben, bleiben unverändert. Sofern angegeben, werden Arrayfelder mit den vorhandenen Arrays überschrieben. Dadurch werden alle vorherigen Array-Elemente verworfen.

quickAdd

Erstellt ein Ereignis auf Basis eines einfachen Textstrings.

Update

Aktualisiert ein Ereignis. Diese Methode unterstützt keine Patch-Semantik und aktualisiert immer die gesamte Ereignisressource. Für eine Teilaktualisierung führen Sie einen get gefolgt von einem update mit ETags aus, um die Atomarität sicherzustellen.

uhr

Achten Sie auf Änderungen an Veranstaltungsressourcen.