Google Kalender

Unterstützte Versionen

Dieser Connector unterstützt Google Calendar REST APIs.

Hinweise

Führen Sie in Ihrem Google Cloud-Projekt die folgenden Aufgaben aus:

  • Prüfen Sie, ob eine Netzwerkverbindung eingerichtet ist. Weitere Informationen finden Sie unter Netzwerkverbindung.
  • Weisen Sie dem Nutzer, der den Connector konfiguriert, die IAM-Rolle roles/connectors.admin zu.
  • Weisen Sie dem Dienstkonto, das Sie für den Connector verwenden möchten, die IAM-Rollen roles/secretmanager.viewer und roles/secretmanager.secretAccessor zu.
  • Aktivieren Sie secretmanager.googleapis.com (Secret Manager API) und connectors.googleapis.com (Connectors API). Weitere Informationen finden Sie unter Dienste aktivieren.

Connector konfigurieren

Eine Verbindung gilt für eine Datenquelle. Wenn Sie also viele Datenquellen haben, müssen Sie für jede Datenquelle eine separate Verbindung erstellen. So erstellen Sie eine Verbindung:

  1. Rufen Sie in der Cloud Console die Seite Integration Connectors > Verbindungen auf und wählen Sie ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Seite „Verbindungen“

  2. Klicken Sie auf + NEU ERSTELLEN, um die Seite Verbindung erstellen zu öffnen.
  3. Führen Sie im Bereich Standort folgende Schritte aus:
    1. Region: Wählen Sie einen Standort aus der Drop-down-Liste aus.

      Eine Liste aller unterstützten Regionen finden Sie unter Standorte.

    2. Klicken Sie auf Weiter.
  4. Führen Sie im Abschnitt Verbindungsdetails folgende Schritte aus:
    1. Connector: Wählen Sie Google Kalender aus der Liste der verfügbaren Connectors aus.
    2. Connector-Version: Wählen Sie die Connector-Version aus der Liste der verfügbaren Versionen aus.
    3. Geben Sie im Feld Verbindungsname einen Namen für die Verbindungsinstanz ein. Der Verbindungsname darf Kleinbuchstaben, Zahlen oder Bindestriche enthalten. Der Name muss mit einem Buchstaben beginnen und mit einem Buchstaben oder einer Ziffer enden und darf nicht länger als 49 Zeichen sein.
    4. Beschreibung: Geben Sie eine Beschreibung für die Verbindungsinstanz ein.
    5. Optional können Sie Cloud Logging aktivieren und dann eine Logebene auswählen. Die Logebene ist standardmäßig auf Error festgelegt.
    6. Dienstkonto: Wählen Sie ein Dienstkonto, das über die erforderlichen Rollen verfügt.
    7. Zeitlimit für Verbindung: Geben Sie optional das Zeitlimit für die Verbindung in Sekunden ein.
    8. Konfigurieren Sie optional die Verbindungsknoteneinstellungen:

      • Mindestanzahl von Knoten: Geben Sie die Mindestanzahl von Verbindungsknoten ein.
      • Maximale Anzahl von Knoten: Geben Sie die maximale Anzahl von Verbindungsknoten ein.

      Ein Knoten ist eine Einheit (oder ein Replikat) einer Verbindung, die Transaktionen verarbeitet. Zur Verarbeitung von mehr Transaktionen für eine Verbindung sind mehr Knoten erforderlich. Umgekehrt sind weniger Knoten erforderlich, um weniger Transaktionen zu verarbeiten. Informationen zu den Auswirkungen der Knoten auf Ihre Connector-Preise finden Sie unter Preise für Verbindungsknoten. Wenn Sie keine Werte eingeben, ist die Mindestanzahl von Knoten standardmäßig auf 2 (für eine bessere Verfügbarkeit) und die maximale Knotenzahl auf 50 gesetzt.

    9. + LABEL HINZUFÜGEN: Klicken Sie hier, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
    10. Klicken Sie auf Weiter.
  5. Geben Sie im Abschnitt Authentifizierung die Authentifizierungsdetails ein.
    1. Wählen Sie einen Authentifizierungstyp aus und geben Sie die relevanten Details ein.

      Die folgenden Authentifizierungstypen werden von der Google Kalender-Verbindung unterstützt:

      • Dienstkonto-Authentifizierung
      • OAuth 2.0 – JWT-Inhaber
      • OAuth 2.0-Autorisierungscode

      Informationen zum Konfigurieren dieser Authentifizierungstypen finden Sie unter Authentifizierung konfigurieren.

    2. Klicken Sie auf Next (Weiter).
  6. Überprüfen: Prüfen Sie Ihre Verbindungs- und Authentifizierungsdetails.
  7. Klicken Sie auf Erstellen.

Authentifizierung konfigurieren

Geben Sie die Details basierend auf der zu verwendenden Authentifizierung ein.

  • Dienstkonto-Authentifizierung: Für diesen Authentifizierungstyp ist keine zusätzliche Konfiguration erforderlich. Das Dienstkonto, das Sie im Abschnitt Verbindungsdetails ausgewählt haben, wird für die Authentifizierung verwendet.
  • OAuth 2.0 – JWT-Inhaber
    • JWT-Zertifikat: Wählen Sie das Zertifikat aus, das für die JWT-Authentifizierung verwendet werden soll.
    • Secret-Version: Geben Sie die Secret-Version des JWT-Zertifikats ein.
    • JWT-Subjekt: Geben Sie das JWT-Subjekt ein.
  • OAuth 2.0-Autorisierungscode
    • Client-ID: Geben Sie die Client-ID ein, die für die OAuth-Authentifizierung verwendet werden soll.
    • Bereiche: Geben Sie eine Liste der gewünschten Bereiche ein.
    • Clientschlüssel: Geben Sie den Clientschlüssel ein, der für die OAuth-Authentifizierung verwendet werden soll.
    • Secret-Version: Geben Sie die Secret-Version des Clientschlüssels ein.

Beispiele für Verbindungskonfigurationen

In diesem Abschnitt werden die Beispielwerte für die verschiedenen Felder aufgeführt, die Sie beim Erstellen der Verbindung konfigurieren.

Dienstkontoverbindungstyp

Feldname Details
Standort us-central1
Connector Google Kalender
Connector-Version 1
Verbindungsname service-account-auth
Cloud Logging aktivieren Ja
Dienstkonto iam.gserviceaccount.com
Mindestanzahl von Knoten 2
Maximale Anzahl von Knoten 50
Authentifizierung Ja
Dienstkonto-Authentifizierung Ja

Verbindungstyp „OAuth 2.0 – JWT-Inhaber“

Feldname Details
Standort us-central1
Connector Google Kalender
Connector-Version 1
Verbindungsname jwt-bearer-auth
Cloud Logging aktivieren Ja
Dienstkonto iam.gserviceaccount.com
Mindestanzahl von Knoten 2
Maximale Anzahl von Knoten 50
Authentifizierung Ja
OAuth 2.0 – JWT-Inhaber Ja
JWT-Zertifikat projects/google-cloud-project/secrets/jwt-cert/versions/1
Secret-Version 1

OAuth 2.0-Verbindungstyp mit Autorisierungscode

Feldname Details
Standort us-central1
Connector Google Kalender
Connector-Version 1
Verbindungsname gcpcloud-googlecalendar-rest-conn
Cloud Logging aktivieren Ja
Dienstkonto iam.gserviceaccount.com
Mindestanzahl von Knoten 2
Maximale Anzahl von Knoten 50
Authentifizierung Ja
Client-ID 60875425788659-mt0cm1tguyiagvst468fvaw7.apps.googleusercontent.com
Umfang https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/drive
Clientschlüssel ygdruoX-Rtyah9gzkdZc-7CB0Eng9hyaufD0VD
Secret-Version 1

Systembeschränkungen

Der Google Kalender-Connector kann maximal 2 Transaktionen pro Sekunde und Knoten verarbeiten. Alle Transaktionen, die dieses Limit überschreiten, werden gedrosselt. Standardmäßig werden für eine Verbindung zwei Knoten (für eine bessere Verfügbarkeit) zugewiesen.

Informationen zu den für Integration Connectors geltenden Limits finden Sie unter Limits.

Google Kalender-Verbindung in einer Integration verwenden

Nachdem Sie die Verbindung erstellt haben, ist sie sowohl in Apigee Integration als auch in Application Integration verfügbar. Sie können die Verbindung in einer Integration über die Aufgabe „Connectors“ verwenden.

  • Informationen zum Erstellen und Verwenden der Connectors-Aufgabe in Apigee Integration finden Sie unter Connectors-Aufgabe.
  • Informationen zum Erstellen und Verwenden der Connectors-Aufgabe in Application Integration finden Sie unter Connectors-Aufgabe.

Beispiele für Entitätsvorgänge

In diesem Abschnitt wird beschrieben, wie Sie einige der Entitätsvorgänge in diesem Connector ausführen.

Beispiel: Alle Kalender auflisten

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Calendars aus der Liste Entity aus.
  3. Wählen Sie den Vorgang List aus und klicken Sie auf Fertig.
  4. Im Bereich Aufgabeneingabe der Aufgabe Connectors können Sie die filterClause gemäß den Kundenanforderungen festlegen.

    5. Der Wert für eine filterClause muss in einfache Anführungszeichen (') gesetzt sein.

    Mit dem filterClause-Parameter können Sie Datensätze anhand der Spalten filtern.

Beispiel: Kalenderdetails abrufen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Calendars aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Get aus und klicken Sie auf Fertig.
  4. Legen Sie entityId auf "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" fest. Dies ist der Schlüssel, der übergeben werden soll.
  5. Klicken Sie zum Festlegen der entityId im Bereich Data Mapper des Datenabgleichs auf Datenabgleichs-Editor öffnen, geben Sie "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" in das Feld Eingabewert ein und legen Sie die entityId als lokale Variable fest.

    6. Der Wert für entityId sollte direkt übergeben werden, z. B. "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com". Dabei ist "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" der eindeutige Primärschlüsselwert, der übergeben werden muss.

    In bestimmten Fällen kann das Übergeben einer entityId einen Fehler auslösen, wenn für die Entität zwei zusammengesetzte Schlüssel verwendet werden. In solchen Fällen können Sie die filterClause verwenden, um den Wert zu übergeben, z. B. id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com'.

Beispiel: Kalender löschen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Calendars aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Delete aus und klicken Sie auf Fertig.
  4. Legen Sie entityId auf "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" fest. Dies ist der Schlüssel, der übergeben werden soll. Wenn Sie die entityId festlegen möchten, klicken Sie im Bereich Data Mapper des Data Mapping auf Open Data Mapping Editor. Geben Sie dann "c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com" in das Feld Input Value ein und legen Sie die entityId als lokale Variable fest.

    Wenn eine Entität zwei zusammengesetzte Geschäfts- oder Primärschlüssel hat, können Sie anstelle der entityId auch die filterClause auf id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com' festlegen.

Beispiel: Kalender erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Calendars aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein und legen Sie connectorInputPayload als lokale Variable fest. 
    {
  "Summary": "New calendar"
}

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload des calendar-Vorgangs einen Wert, der in etwa so aussieht:

    {
  "Id": "c_5bae32e1c48ed38af98efecbd6da6bb002a31e887276aa65cc2530717123b75f@group.calendar.altostrat.com"
}

Beispiel: Termin in einem Kalender erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie AllCalendars aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein und legen Sie connectorInputPayload als lokale Variable fest. 
    {
  "Summary": "New event",
  "CalendarId": "c_b4e891cebb19267bf5ac838f0c5f691bee164a7cec9dcc1a93e54625279baa80@group.calendar.altostrat.com",
  "StartDate": "2025-09-01",
  "EndDate": "2025-09-02"
}

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload des calendar-Vorgangs einen Wert, der dem folgenden ähnelt:

    {
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}

Beispiel: Termin in Ihrem Hauptkalender erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Ihre E‑Mail-ID aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein und legen Sie connectorInputPayload als lokale Variable fest. 
    {
  "Summary": "new event for my calendar",
  "CalendarId": "xyz@xwf.altostrat.com",
  "StartDate": "2025-09-01",
  "EndDate": "2025-09-02"
}

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload des AllCalendars-Vorgangs einen Wert, der dem folgenden ähnelt:

    {
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}

Beispiel: Einen Termin in einem Kalender erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie AllCalendars aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein und legen Sie connectorInputPayload als lokale Variable fest. 
    {
  "EventType": "outOfOffice",
  "Summary": "outOfOffice",
  "CalendarId": "xyz@xwf.altostrat.com",
  "StartDateTime": "2025-09-03 14:00:00",
  "EndDateTime": "2025-09-03 15:00:00"
}

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload des AllCalendars-Vorgangs einen Wert, der dem folgenden ähnelt:

    {
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}

Beispiel: Wiederkehrenden Termin in einem Kalender erstellen

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie AllCalendars aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Create aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein und legen Sie connectorInputPayload als lokale Variable fest. 
    {
  "Summary": "Google Cloud Recurring event",
  "CalendarId": "xyz@xwf.altostrat.com",
  "StartDateTime": "2025-11-2 14:00:00",
  "EndDateTime": "2025-11-2 14:30:00",
  "Recurrences": "RRULE:FREQ=WEEKLY;BYDAY=TH;COUNT=5",
  "StartDateTimeZone": "America/Los_Angeles",
  "EndDateTimeZone": "America/Los_Angeles"
}

    Wenn die Integration erfolgreich ist, hat der Antwortparameter connectorOutputPayload des AllCalendars-Vorgangs einen Wert, der dem folgenden ähnelt:

    {
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}

Beispiel: Kalenderdetails aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie Calendars aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Datenabgleich auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein und legen Sie connectorInputPayload als lokale Variable fest. 
    {
  "Summary": "Updated from Google Cloud"
}
  5. Legen Sie die entityId im Data Mapper auf die Entität des Kalenders fest.
  6. Klicken Sie zum Festlegen der entityId auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Legen Sie die entityId als lokale Variable fest.

    Anstelle der entityId können Sie auch die filterClause auf id='c_3054d6e09a9dfae7886f995311@group.calendar.altostrat.com' festlegen.

    Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload der Connector-Aufgabe zurückgegeben:

    {
  "Id": "c_5bae32e1c48ed38af98efecbd6da6bb002a31e887276aa65cc2530717123b75f@group.calendar.altostrat.com"
}

Beispiel: Alle Kalenderdetails aktualisieren

  1. Klicken Sie im Dialogfeld Configure connector task auf Entities.
  2. Wählen Sie AllCalendars aus der Liste Entity aus.
  3. Wählen Sie den Vorgang Update aus und klicken Sie auf Fertig.
  4. Klicken Sie im Bereich Data Mapper der Aufgabe Data Mapping auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Legen Sie „connectorInputPayload“ als lokale Variable fest. 
    {
  "Summary": "Great event"
}
  5. Legen Sie die entityId im Data Mapper auf die Entität von AllCalendars fest.
  6. Klicken Sie zum Festlegen der entityId auf Open Data Mapping Editor und geben Sie dann einen Wert ähnlich dem folgenden in das Feld Input Value ein. Legen Sie die entityId als lokale Variable fest.

    Anstelle der entityId können Sie auch die filterClause auf Summary='New sep event' festlegen.

    Wenn Sie dieses Beispiel ausführen, wird eine Antwort ähnlich der folgenden in der Ausgabevariable connectorOutputPayload der Connector-Aufgabe zurückgegeben:

    {
  "Id": "fnf0p7292pbm2buk59ubc1a37k",
  "CalendarId": null
}

Hilfe von der Google Cloud-Community erhalten

Sie können Ihre Fragen und Anregungen zu diesem Connector in der Google Cloud-Community unter Cloud-Foren posten.

Nächste Schritte