Nutzer zu einem Termin einladen

Termin erstellen

Wenn Sie Schreibzugriff auf den Google Kalender des Organisators haben, können Sie mit der Methode ein Events: insert Ereignis hinzufügen.

Mit dieser Methode wird der Termin direkt dem Kalender des Organisators hinzugefügt, unabhängig von der Einstellung des Organisators zum Hinzufügen von Einladungen.

Teilnehmer hinzufügen

Mit dieser Methode können Sie dem Termin auch Teilnehmer hinzufügen, indem Sie ihre E‑Mail-Adresse der attendees Eigenschaft des Termins hinzufügen. Alle zukünftigen Änderungen, die der Organisator am Termin vornimmt, werden weitergegeben an die Teilnehmer.

Die Teilnehmer erhalten die Einladung von der E‑Mail-Adresse des Organisators. Google Kalender-Nutzer erhalten die Einladung je nach ihren Termineinstellungen in den Google Kalender-Einstellungen per E‑Mail und/oder in ihrem Kalender:

• Wenn die Einstellung From everyone festgelegt ist, wird der Termin direkt ihrem Kalender hinzugefügt.
• Wenn die Einstellung Only if the sender is known festgelegt ist, wird der Termin direkt ihrem Kalender hinzugefügt, wenn sie zuvor mit dem Organisator interagiert haben, wenn der Organisator derselben Organisation angehört oder wenn der Organisator in ihren Google-Kontakten gespeichert ist. Wenn sie den Organisator nicht kennen, können sie in der Einladungs-E‑Mail auf Zum Kalender hinzufügen klicken oder mit Ja oder Vielleicht antworten. Der Termin wird dann ihrem Kalender hinzugefügt.
• Wenn die Einstellung When I respond in email festgelegt ist, werden alle Einladungen erst dann ihrem Kalender hinzugefügt, wenn der Nutzer mit Ja, Vielleicht, oder Nein in der E‑Mail-Einladung antwortet.

Weitere Informationen zum Hinzufügen von Einladungen zu Google Kalender finden Sie unter Einladungen in Google Kalender verwalten.

Wichtig: Wenn Sie die Antwort des Teilnehmers mit der Eigenschaft attendees[].responseStatus vorab ausfüllen, wird der Termin nicht automatisch den Kalendern der Gäste hinzugefügt. Wenn außerdem mehr als 200 Gäste zu dem Termin eingeladen werden, wird der Antwortstatus nicht an die Gäste weitergegeben.

Termin direkt in den Kalendern der Teilnehmer anzeigen

Wenn Sie einen Termin direkt in den Google Kalender-Kalendern der Teilnehmer anzeigen möchten, unabhängig von den Einstellungen des Teilnehmers, können Sie die Antwort des Teilnehmers festlegen oder eine Kopie des Termins direkt in den Kalender des Teilnehmers importieren. Für beide Methoden benötigen Sie Schreibzugriff auf die Kalender der Teilnehmer . Wenn Sie keinen Schreibzugriff haben, können Sie den Organisator den Kontakten des Teilnehmers hinzufügen. Dazu ist möglicherweise Schreibzugriff auf die Kontakte des Teilnehmers erforderlich.

Antwort des Teilnehmers festlegen

So legen Sie die Antwort eines Teilnehmers auf eine Einladung fest:

1. Erstellen Sie den Termin im Kalender des Google Kalender-Organisators und fügen Sie Teilnehmer hinzu (siehe oben).
2. Verwenden Sie die Events: update Methode um die Antwort des Teilnehmers auf accepted oder tentative festzulegen. Sie benötigen Schreibzugriff auf den Kalender des Teilnehmers. Es kann etwas dauern, bis der Termin im Kalender des Teilnehmers angezeigt wird. Weitere Informationen zur Verwendung der Methode Events: update.

Mit dieser Methode wird der Termin dem Kalender des Teilnehmers hinzugefügt. Der Teilnehmer sieht aber möglicherweise weiterhin das Banner in seiner E‑Mail, dass die Einladung von einer Adresse gesendet wurde, die ihm bisher unbekannt war.

Kopie des Termins direkt in den Kalender des Teilnehmers importieren

So importieren Sie eine Kopie eines Termins in den Kalender eines Teilnehmers:

1. Wenn Sie Schreibzugriff auf den Google Kalender des Organisators haben, importieren Sie mit der Methode Events: import eine Kopie des Termins.
2. Importieren Sie mit Events: import eine weitere Kopie desselben Termins in den Kalender des Teilnehmers. Sie benötigen Schreibzugriff auf den Kalender des Teilnehmers. Verwenden Sie für die Kopien des Organisators und des Teilnehmers dieselbe Termin-ID (iCalUID) und geben Sie den Organisator in der Kopie des Teilnehmers an.

Mit dieser Methode kann der Teilnehmer den Termin in seinem Kalender sehen, erhält aber keine Einladungs-E‑Mail von Google Kalender.

Wichtig: Wenn Sie nicht dieselbe Termin-ID verwenden, werden zukünftige Änderungen am Termin die vom Organisator vorgenommen werden, nicht automatisch an den Gast weitergegeben.

Organisator den Kontakten des Teilnehmers hinzufügen

Wenn Sie die Anmeldedaten des Teilnehmers nicht haben, können Sie den Teilnehmer oder seine Organisation bitten, die E‑Mail-Adresse des Organisators vorab zu ihren Google-Kontakten hinzuzufügen, damit ein Termin direkt in ihrem Kalender angezeigt wird. Es kann etwas dauern, bis ein neu erstellter Kontakt wirksam wird.

• Bitten Sie den Google Kalender-Nutzer, den Organisator seinen Google-Kontakten hinzuzufügen.
• Wenn die Teilnehmer einer Organisation angehören, können Sie den Administrator der Organisation bitten, E‑Mail-Adressen programmatisch den Kontakten der Nutzer hinzuzufügen. Bitten Sie den Administrator, die domänenweite Übertragung zu aktivieren, die Nutzer zu imitieren und mit der People: createContact Methode Kontakte für jeden Nutzer zu erstellen, damit zukünftige Einladungen von diesen E‑Mail-Adressen automatisch in den Kalendern der Nutzer angezeigt werden.
• Wenn Sie Zugriff auf die Kontakte des Teilnehmers haben, können Sie die E‑Mail-Adresse des Organisators auch mit der People: createContact Methode den Kontakten des Teilnehmers hinzufügen.

Nutzer über eine E‑Mail-Adresse einladen

Wenn Sie keinen Schreibzugriff auf den Google Kalender des Organisators haben oder die E‑Mail-Adresse des Organisators nicht preisgeben möchten, verwenden Sie das iCalendar Protokoll (RFC-5545) , um Nutzer mit einer E‑Mail-Adresse über eine .ICS-Datei einzuladen.

Wenn der Teilnehmer ein Google Kalender-Nutzer mit der Einstellung Only if the sender is known ist und er zuvor nicht mit der Adresse interagiert oder sie als bekannt gespeichert hat, wird die Einladung erst dann seinem Kalender hinzugefügt, wenn er auf Zum Kalender hinzufügen klickt oder auf die Einladung antwortet.

Tipp: Verwenden Sie keine allgemeine E‑Mail-Adresse (z. B. [e-mail]), um Einladungen zu senden, da Missbrauch alle Nutzer betreffen kann, die Einladungen von dieser Adresse senden. Wenn Sie die E‑Mail-Adresse des Organisators nicht verwenden können, empfehlen wir, für jeden Organisator eine eindeutige und statische E‑Mail-Adresse zu verwenden.

Link bereitstellen, über den Nutzer den Termin hinzufügen können

Alternativ können Sie Google Kalender-Nutzern das Hinzufügen eines Termins als einmaligen Termin erleichtern, ohne ihn auf dem neuesten Stand zu halten. Dazu können Sie einen Link mit einem vorab ausgefüllten Termin bereitstellen, den der Nutzer hinzufügen kann. Mit dieser Methode wird ein separater Termin im Kalender des Nutzers erstellt, den Sie nur aktualisieren können, wenn Sie Zugriff auf den Kalender des Nutzers haben.

Verwenden Sie die folgende Linkvorlage:

https://calendar.google.com/calendar/r/eventedit?action=TEMPLATE&dates=20230325T224500Z%2F20230326T001500Z&stz=Europe/Brussels&etz=Europe/Brussels&details=EVENT_DESCRIPTION_HERE&location=EVENT_LOCATION_HERE&text=EVENT_TITLE_HERE

Aktualisieren Sie die folgenden Informationen:

• Start- und Enddatum und ‑zeit: Verwenden Sie das ISO 8601-Format. Ersetzen Sie im obigen Beispiel 20230325T224500Z und 20230326T001500Z.
• Start- und Endzeitzonen: Formatieren Sie sie als Namen aus der IANA-Zeitzonendatenbank. Platzieren Sie die Zeitzonen in den Feldern stz und etz.
• Terminbeschreibung: Muss URL-codiert sein.
• Veranstaltungsort: Muss URL-codiert sein.
• Termintitel: Muss URL-codiert sein.

Beispiel

Nehmen wir das Beispiel eines Terminbuchungsdienstes, mit dem Nutzer Termine bei einem Unternehmen buchen können. Wenn ein Nutzer einen Termin bucht, soll Ihr Dienst den Google Kalendern des Buchers und des Unternehmens einen Termin hinzufügen.

Für eine optimale Nutzererfahrung empfehlen wir, dass das Unternehmen Schreibzugriff auf seinen Kalender gewährt, damit Sie den Termin direkt dem Kalender des Unternehmens hinzufügen (Termin erstellen) und den Bucher zu diesem Termin einladen können (Teilnehmer hinzufügen). Damit der Bucher den Termin in seinem Kalender sieht und daran erinnert wird, bitten Sie ihn, seine E‑Mails zu prüfen und sofort nach der Buchung mit Ja auf die Einladung zu antworten. Sobald er auf die Einladung geantwortet hat, erhält er gemäß seinen Benachrichtigungseinstellungen Terminbenachrichtigungen von Google Kalender.

Wenn Sie den Termin direkt dem Kalender des Buchers hinzufügen möchten, bitten Sie ihn , die E‑Mail-Adresse, von der er die Einladung erhält, seinen Kontakten hinzuzufügen. Alternativ können Sie den Bucher um Schreibzugriff auf seinen Kalender bitten, um in seinem Namen programmatisch zu antworten (Antwort des Teilnehmers festlegen) und ihm eine E‑Mail Benachrichtigung über die bestätigte Buchung zu senden.

Wenn das Unternehmen seine E‑Mail-Adresse nicht preisgeben möchte, verwenden Sie eine nutzerspezifische E‑Mail-Adresse, um den Termin per E‑Mail an den Bucher zu senden (Nutzer über eine E‑Mail-Adresse einladen).

Terminweitergabe

Das folgende Diagramm veranschaulicht die Dynamik. Zuerst erstellt Jack einen Termin in seinem primären Kalender (und ist somit der Organisator). Dann lädt er den sekundären Kalender der Cellounterrichtsgruppe und Susan ein, die die Termineinstellung Only if the sender is known festgelegt hat. Kopien für die Teilnehmer werden im sekundären Kalender der Cellounterrichtsgruppe und im Kalender von Susan erstellt, wenn sie Jack kennt. Andernfalls werden sie erstellt, wenn sie auf die Einladung antwortet oder angibt, dass sie Jack kennt. Wenn Susan antwortet, wird die Änderung der Antwort an den Organisator weitergegeben und die Kopie des Organisators mit der Antwort von Susan aktualisiert. Diese Änderungen an der Kopie des Termins des Organisators werden dann an die anderen Teilnehmer weitergegeben.

Freigegebene Terminattribute

Der Kalender, in dem der Termin erstellt wird, ist der Kalender des Organisators. Dieser Kalender enthält die freigegebenen Termininformationen, einschließlich ID, Start- und Endzeit, Zusammenfassung und Beschreibung. Wenn diese Informationen im Kalender des Organisators aktualisiert werden, werden die Änderungen an die Kopien der Teilnehmer weitergegeben.

Private Terminattribute

Nicht alle Informationen werden zwischen allen Terminkopien geteilt. Einige Attribute sind privat, z. B. Erinnerungen, colorId, Transparenz oder die Eigenschaft extendedProperties.private. Diese Attribute werden durch die Einstellungen des Teilnehmers und nicht durch den Kalender des Organisators gesteuert.

Teilnehmer können auch die freigegebenen Attribute des Termins ändern. Diese Änderungen werden jedoch nur in ihrer eigenen Kopie berücksichtigt und können verloren gehen, wenn der Organisator eine Änderung vornimmt.

Die einzige Terminänderung, die von den Teilnehmern an den Organisator weitergegeben wird, ist der Antwortstatus des Teilnehmers, der in der attendees[].responseStatus Eigenschaft gespeichert ist.