Wie verwendet man die Google Calendar API v3: Kosten, Limits, Beispiele

Was ist die Google Calendar API?

Es ermöglicht Ihnen, Kalendereinträge anzuzeigen, zu erstellen und damit zu arbeiten, sowie mit anderen kalenderbezogenen Objekten zu interagieren – zum Beispiel Zugriffskontrollen. Jetzt werfen wir einen Blick auf einige Ideen, wie Sie beginnen können, mit dem Google Calendar API-Entwickler-Schlüssel zu arbeiten.

So arbeiten Sie damit

• Veranstaltungen erstellen. Google Calendar ist ein großartiges Tool, um Nutzer organisiert zu halten. Damit kannst du zum Beispiel eine Wanderroute als Kalendereintrag hinzufügen und jeden Teilnehmer daran erinnern, damit alle stressfrei vorbereitet bleiben.
• Wiederkehrende Ereignisse. Einige Ereignisse treten mehrmals auf – tägliche Meetings, Geburtstage oder Feiertage. In der Regel sind sie identisch und haben dieselbe Start- und Endzeit.
• Ressourcen synchronisieren: Sie können die Daten aller Kalender-Sammlungen synchronisieren und so Bandbreite sparen.
• Push-Benachrichtigungen nutzen. Es besteht die Möglichkeit, Push-Benachrichtigungen zu verwenden, die Ihre Anwendung informieren, wenn sich eine Ressource ändert.
• Ressourcen synchronisieren. Die Google Calendar API hilft Ihnen, Daten aller Kalenderkollektionen synchron zu halten und dabei Bandbreite zu sparen.

• Event – eine Kalenderfunktion mit Titel, Start- und Endzeiten sowie Teilnehmern.
• Kalender – eine Sammlung von Veranstaltungen.
• Kalenderliste – eine Liste aller Kalender in der Kalender-UI
• Einstellungen – eine Präferenz aus der Kalenderoberfläche, z. B. die Zeitzone des Nutzers.
• ACL – eine Zugriffskontrollregel, die einem Benutzer eine spezielle Berechtigungsstufe für einen Kalender gewährt.
• Farbe – eine Farbe, die in der Kalenderoberfläche angezeigt wird
• Frei/Belegt – Zeiten, in denen der Kalender Termine als „Belegt“ anzeigt oder keine Termine vorhanden sind und daher als „Frei“ gilt.

Verwenden Sie die Kalender-API

Jede Anforderung, die Ihre Anwendung an Calendar API v3 sendet, benötigt ein Autorisierungstoken. Dieses Token identifiziert auch die Anwendung gegenüber Google. Die Anwendung muss OAuth 2.0 verwenden, um Anfragen zu autorisieren – andere Autorisierungsprotokolle werden nicht unterstützt.<br><br>

1. Bei der Erstellung der Anwendung registrieren Sie sie mithilfe der Google Calendar API Console. Google stellt Ihnen eine Client-ID und ein Client-Secret zur Verfügung. Sie benötigen diese Informationen später.
2. Aktivieren Sie die Google Kalender API in der API-Konsole. Falls sie dort nicht aufgeführt ist, überspringen Sie diesen Schritt.
3. Benötigt Ihre Anwendung Zugriff auf Nutzerdaten, bittet sie Google um den passenden Berechtigungsumfang.
4. Dann zeigt Google dem Nutzer ein Zustimmungsfenster, in dem er Ihrer Anwendung die Erlaubnis erteilen soll, auf einige seiner Daten zuzugreifen.
5. Wenn der Benutzer seine Zustimmung erteilt, erhält Ihre Anwendung von Google ein kurzlebiges Zugriffstoken.
6. Dann fordert Ihre Anwendung Benutzerdaten an und hängt das Token an die Anfrage an.
7. Falls Google Ihre Anfrage und Ihren Token als gültig erkennt, werden die angeforderten Daten zurückgegeben.

_{Wenn Sie Glück haben und freigegeben werden, erhalten Sie Zugriff auf die Kalender-API-Dokumentation, damit Sie mit der Entwicklung Ihrer integrierten Software beginnen können.}

Falls Sie eine einfache und schnelle Möglichkeit suchen, einen Kalender in Ihre Website einzubinden, ziehen Sie das Event Calendar von Elfsight in Betracht. Es ermöglicht Ihnen, Ihre Veranstaltungen mühelos in den Google-Suchergebnissen zu präsentieren.

Kalender-API: Beispiele

Google Kalender-API: Ereignis erstellen

• calendarId – Die Kalenderkennung. Sie kann entweder die E-Mail-Adresse des Kalenders sein, in dem Sie ein Ereignis erstellen, oder das spezielle Schlüsselwort ‘primary’, das den primären Kalender des angemeldeten Benutzers verwendet.
• Ein Ereignis ist das zu erstellende Ereignis mit allen notwendigen Informationen wie Start- und Endzeit. Die einzigen beiden Pflichtfelder hier sind Start- und Endzeit. 

Das folgende Beispiel demonstriert den Prozess der Erstellung einer Veranstaltung und der Festlegung ihrer Metadaten:

API für wiederkehrende Termine

Diese Termine treten regelmäßig mehrfach auf, zum Beispiel tägliche Meetings, Geburtstage oder Feiertage. Hier ist ein Beispiel für ein Ereignis, das jeden Dienstag und Freitag von 6:00 bis 7:00 Uhr stattfindet, beginnend am 15. September 2015 und nach dem fünften Termin am 29. September endet:

Und hier sehen Sie ein ganztägiges Ereignis, das am 1. Juni 2015 beginnt und im gesamten Monat alle drei Tage wiederholt wird, den 10. Juni ausschließt, aber den 9. und 11. Juni einschließt:

Ressourcen synchronisieren

Diese Methode hilft Ihnen, Daten aller Kalenderkollektionen synchron zu halten. Die inkrementelle Synchronisierung besteht aus zwei Phasen:

• Die anfängliche vollständige Synchronisierung erfolgt einmal zu Beginn, um den Zustand von Client und Server vollständig zu synchronisieren.
• Inkrementelle Synchronisierung wird wiederholt durchgeführt und aktualisiert den Client mit allen Änderungen seit dem letzten Update.

Hier ist ein Beispiel für ein Synchronisationstoken:

Push-Benachrichtigungen

Die Google Calendar API v3 bietet Ihnen die Möglichkeit, Push-Benachrichtigungen zu erhalten, mit denen Sie Änderungen an Ressourcen überwachen können. Diese Funktion können Sie verwenden, um Ihre Anwendung zu verbessern.

Sie benötigen drei Dinge, um Push-Benachrichtigungen zu nutzen:

• Registrieren Sie die Domain Ihrer Ziel-URL.
• Richten Sie Ihre Empfangs-URL oder Ihren Webhook-Empfänger ein.
• Richten Sie für jeden Endpunkt, den Sie überwachen möchten, einen Benachrichtigungskanal ein.

Das folgende Beispiel zeigt, wie Sie Änderungen an einer Sammlung von Veranstaltungen überwachen können:

Kalender-API-Limits

Die Calendar-API hat eine Grenze von 1.000.000 Anfragen pro Tag. Wenn du deine Nutzungsgrenzen ändern oder dein Kontingent erhöhen möchtest, befolge die folgenden Schritte:

• Erstellen Sie ein Abrechnungskonto, falls Sie noch keines haben.
• Öffnen Sie die Seite der aktivierten APIs in der API-Bibliothek der Google-Konsole und wählen Sie eine API aus der Liste aus.
• Quoten auswählen, um kontingentbezogene Einstellungen anzuzeigen und zu ändern.

Sie können Ihre Nutzungsstatistiken auch im Nutzungsbereich einsehen.

Es gibt weitere Widgets, die Ihnen helfen, Daten aus der Plattform zu nutzen. Eines der nützlichsten Tools für jedes Unternehmen ist das Google-Bewertungen-Widget. Es bietet eine äußerst umfangreiche Funktionalität und ermöglicht es nicht nur, Google-Bewertungen einzubetten, sondern erstellt auch Rich-Snippets für Suchergebnisse.

Häufige Fragen

Fazit

Artikel von

Valeriya Polyakova

Content-Manager

Als Content-Manager bei Elfsight erstelle ich Inhalte, die sowohl praktisch als auch inspirierend sind. Ich liebe es, Komplexes einfach und angenehm lesbar zu gestalten.

Auf Facebook folgen

Folgen Sie uns auf X

Auf LinkedIn folgen

Folge uns auf Reddit