Nutzer zu einem Termin einladen

Ereignis erstellen

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

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

Teilnehmer hinzufügen

Mit dieser Methode können Sie dem Ereignis auch Teilnehmer hinzufügen, indem Sie ihre E‑Mail-Adresse der attendees Eigenschaft des Ereignisses hinzufügen. Alle zukünftigen Änderungen, die der Organisator am Ereignis 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 Ereigniseinstellungen in den Google Kalender-Einstellungen per E‑Mail und/oder in ihrem Kalender:

Wenn die Einstellung From everyone festgelegt ist, wird das Ereignis direkt ihrem Kalender hinzugefügt.
Wenn die Einstellung Only if the sender is known festgelegt ist, wird das Ereignis 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. Das Ereignis 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 Einladungs-E‑Mail antwortet.

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

Ereignis direkt in den Kalendern der Teilnehmer anzeigen

Wenn Sie ein Ereignis direkt in den Kalendern der Google Kalender-Teilnehmer anzeigen möchten, unabhängig von den Einstellungen des Teilnehmers, können Sie die Antwort des Teilnehmers festlegen oder eine Kopie des Ereignisses 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 ein Ereignis fest:

Erstellen Sie das Ereignis im Kalender des Google Kalender-Organisators und fügen Sie Teilnehmer hinzu (siehe oben).
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 eine kurze Verzögerung auftreten, bis das Ereignis im Kalender des Teilnehmers angezeigt wird. Weitere Informationen zur Verwendung der Methode Events: update.

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

Kopie des Ereignisses direkt in den Kalender des Teilnehmers importieren

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

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

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

Organisator den Kontakten des Teilnehmers hinzufügen

Wenn Sie die Anmeldedaten des Teilnehmers nicht haben, können Sie den Teilnehmer oder seine Organisation anweisen, die E‑Mail-Adresse des Organisators vorab zu den Google-Kontakten hinzuzufügen, damit ein Ereignis direkt in seinem Kalender angezeigt wird. Es kann eine kurze Verzögerung auftreten, bis ein neu erstellter Kontakt wirksam wird.

Bitten Sie den Google Kalender-Nutzer, den Organisator zu 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.

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

Alternativ können Sie Google Kalender-Nutzern das Hinzufügen eines Ereignisses als einmaligen Termin erleichtern, ohne es auf dem neuesten Stand zu halten. Dazu können Sie einen Link mit einem vorab ausgefüllten Ereignis bereitstellen, das der Nutzer hinzufügen kann. Mit dieser Methode wird ein separates Ereignis im Kalender des Nutzers erstellt, das 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 dazu 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.
Ereignisbeschreibung: Muss URL-codiert sein.
Veranstaltungsort: Muss URL-codiert sein.
Ereignistitel: 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 ein Ereignis hinzufügen.

Für eine optimale Nutzererfahrung empfehlen wir, dass das Unternehmen Schreibzugriff auf seinen Kalender gewährt, damit Sie das Ereignis direkt dem Kalender des Unternehmens hinzufügen (Ereignis erstellen) und den Bucher zu diesem Ereignis einladen können (Teilnehmer hinzufügen). Damit der Bucher das Ereignis 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 Ereignisbenachrichtigungen von Google Kalender.

Wenn Sie das Ereignis direkt dem Kalender des Buchers hinzufügen möchten, bitten Sie ihn , die E‑Mail-Adresse, von der er die Einladung erhält, zu 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 das Ereignis per E‑Mail an den Bucher zu senden (Nutzer über eine E‑Mail-Adresse einladen).

Ereignisweitergabe

Das folgende Diagramm veranschaulicht die Dynamik. Zuerst erstellt Jack ein Ereignis in seinem primären Kalender (und ist somit der Organisator). Dann lädt er den sekundären Kalender der Cellostunden-Gruppe und Susan ein, die die Ereigniseinstellung Only if the sender is known festgelegt hat. Kopien für die Teilnehmer werden im sekundären Kalender der Cellostunden-Gruppe 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 Ereignisses des Organisators werden dann an die anderen Teilnehmer weitergegeben.

Gemeinsame Ereigniseigenschaften

Der Kalender, in dem das Ereignis erstellt wird, ist der Kalender des Organisators. Dieser Kalender enthält die gemeinsamen Ereignisinformationen, 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 Ereigniseigenschaften

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

Teilnehmer können auch die gemeinsamen Eigenschaften des Ereignisses ä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 Ereignisänderung, die von den Teilnehmern an den Organisator weitergegeben wird, ist der Antwortstatus des Teilnehmers, der in der attendees[].responseStatus Eigenschaft gespeichert ist.