Gmail-Verbindung im Jitterbit Studio

Einführung

Eine Gmail-Verbindung, die mit dem Gmail-Connector erstellt wurde, ermöglicht den Zugriff auf Gmail. Sobald eine Verbindung konfiguriert ist, können Instanzen von Gmail-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Erstellen oder Bearbeiten einer Gmail-Verbindung

Eine neue Gmail-Verbindung wird mit dem Gmail-Connector aus einem dieser Standorte erstellt:

• Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Seite Globale Endpunkte (siehe Einen globalen Endpunkt erstellen in Globale Endpunkte).

Eine vorhandene Gmail-Verbindung kann von diesen Standorten aus bearbeitet werden:

• Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Registerkarte Komponenten im Projektbereich (siehe Aktionenmenü für Komponenten in Projektbereich Komponenten-Registerkarte).
• Der Seite Globale Endpunkte (siehe Einen globalen Endpunkt bearbeiten in Globale Endpunkte).

Konfigurieren einer Gmail-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Gmail-Verbindung wird im Folgenden beschrieben.

• Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Gmail-Verbindung einzigartig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Gmail-Endpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

• Authentifizierung: Wählen Sie die Methode der Authentifizierung, entweder Authorization Code Grant (Standard) oder Service Account.

  • Authorization Code Grant: Wählen Sie diese Option, um 3-legged OAuth 2.0 (3LO) zur Authentifizierung zu verwenden. Für wichtige Hinweise zum Verhalten von Zugriffstoken und Aktualisierungstoken siehe Wichtige Hinweise.

    • OAuth-Anwendung: Wählen Sie eine in der Management-Konsole konfigurierte Gmail-Connector-Anwendung auf der Seite App-Registrierungen. Weitere Informationen zur Konfiguration einer Gmail-Connector-Anwendung auf der Seite App-Registrierungen finden Sie in den Gmail-3-legged OAuth 2.0 (3LO) Voraussetzungen.

    • Mit Google-Konto anmelden: Klicken Sie, um sich über Google in einem separaten Browser-Tab zu authentifizieren und Jitterbit die Zustimmung zu erteilen, auf die Gmail-Anwendung zuzugreifen.

• Dienstkonto: Wählen Sie diese Option, um ein Google Cloud Dienstkonto zur Authentifizierung zu verwenden.

  • Benutzer-Email: Geben Sie die Email-Adresse ein, die Sie nachahmen möchten. Emails erscheinen so, als würden sie von dieser Email-Adresse gesendet.

  • Client-Email: Geben Sie die Email-Adresse des Dienstkontos ein, die beim Erstellen des Dienstkontos generiert wurde.

  • Privater Schlüssel: Geben Sie den privaten Schlüssel ein, der mit dem Dienstkonto verknüpft ist.

  • Scopes: Geben Sie die Gmail-Scopes ein, die vom Dienstkonto im Scopes-Tabellenfeld benötigt werden:

    Scope	Aktivität
    https://mail.google.com/	Alle
    https://www.googleapis.com/auth/gmail.modify	Alle
    https://www.googleapis.com/auth/gmail.compose	Senden
    https://www.googleapis.com/auth/gmail.send	Senden
    https://www.googleapis.com/auth/gmail.readonly	Lesen
    https://www.googleapis.com/auth/gmail.metadata	Lesen

    Klicken Sie auf das Hinzufügen-Symbol , um eine Zeile zur Tabelle hinzuzufügen und einen Scope-Wert einzugeben.

    Um die Zeile zu speichern, klicken Sie auf das Senden-Symbol in der rechten Spalte.

    Um eine einzelne Zeile zu bearbeiten oder zu löschen, fahren Sie mit der Maus über die rechte Spalte und verwenden Sie das Bearbeiten-Symbol oder das Löschen-Symbol .

    Um alle Zeilen zu löschen, klicken Sie auf Alle löschen.

• Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

  • Verbindungs-Timeout: Geben Sie den Verbindungs-Timeout-Wert in Millisekunden ein. Der Standardwert beträgt 20000.

  • Lese-Timeout: Geben Sie den Lese-Timeout-Wert in Millisekunden ein. Der Standardwert beträgt 60000.

• Test: Klicken Sie, um die Verbindung mit der angegebenen Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Deaktivieren Sie die automatische Connector-Aktualisierung Organisationsrichtlinie.

• Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

• Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

• Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung wirklich löschen möchten.

Nächste Schritte

Nachdem eine Gmail-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfstafel, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

• Email senden: Sendet eine Email mit Gmail und ist als Ziel in einem Vorgang vorgesehen.

• Email lesen: Ruft Emails von Gmail ab und ist als Quelle in einem Vorgang vorgesehen.