<ph type="x-smartling-placeholder"></ph> Weitere Informationen finden Sie unter Unterstützte Connectors für Application Integration.

API-Trigger

API-Trigger werden verwendet, um Ausführungen für Integrationen direkt aufzurufen. API-Trigger können kann im synchronen oder asynchronen Modus verwendet werden.

Sie können die Anfrage- und Antwortnutzlast für den API-Trigger festlegen, indem Sie in Ihrer Integration Variablen erstellen. Informationen zum Erstellen einer Integration mit einem API-Trigger, der API-Anfragen zum Abrufen von Kundendaten empfängt, finden Sie in der Anleitung API-Auftragsausführung.

API-Trigger hinzufügen

Führen Sie die folgenden Schritte aus, um einen API-Trigger hinzuzufügen:
  1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

    Zu Application Integration

  2. Klicken Sie im Navigationsmenü auf Integrations (Integrationen).

    Auf der Seite Integrationsliste werden alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.

  3. Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Verknüpfung erstellen, um eine neue zu erstellen.

    Wenn Sie eine neue Integration erstellen, gehen Sie so vor:

    1. Geben Sie im Bereich Create Integration (Integration erstellen) einen Namen und eine Beschreibung ein.
    2. Wählen Sie eine Region für die Integration aus.
    3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Dienstkontodetails einer Integration jederzeit in der Symbolleiste der Verknüpfung im Bereich Zusammenfassung ändern oder aktualisieren.
    4. Klicken Sie auf Erstellen.

    Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.

  4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger, um die Liste der verfügbaren Trigger aufzurufen.
  5. Klicken Sie auf das Element API-Trigger und platzieren Sie es im Designer.

API-Trigger konfigurieren

Klicken Sie im Integrationseditor auf das Element API-Trigger, um den Bereich für die Triggerkonfiguration aufzurufen.

Im Konfigurationsbereich wird die Trigger-ID angezeigt, die eine maschinengenerierte ID im Format api_trigger/TRIGGER_NAME ist. Für diesen Trigger ist keine weitere Konfiguration erforderlich.

API-Trigger aus einer Anwendung aufrufen

Nachdem Sie eine Integration veröffentlicht haben, in der ein API-Trigger konfiguriert ist, können Sie diesen Trigger mit der Methode projects.locations.integrations.execute von jeder Anwendung aus aufrufen. Diese Methode löst die Ausführung im synchronen Modus aus.

Syntax

curl -X POST \
    -H "authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{"trigger_id":"api_trigger/TRIGGER_NAME"}' \
    "https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-:execute"

Ersetzen Sie Folgendes:

  • TRIGGER_NAME: Der Name des API-Triggers in der Integration.
  • PROJECT_ID: ID Ihres Google Cloud-Projekts.
  • LOCATION: Der Standort Ihres Google Cloud-Projekts.

Beispiel

Im folgenden Beispiel wird eine Integration in der Region us-east1 aufgerufen, die den test_API_1 API-Trigger im Google Cloud-Projekt demo-project enthält:

curl -X POST \
    -H "authorization: Bearer $(gcloud auth print-access-token)"
    -H "Content-Type: application/json" \
    -d '{"trigger_id":"api_trigger/test_API_1"}' \
    "https://us-east1-integrations.googleapis.com/v1/projects/demo-project/locations/us-central1/integrations/-:execute"

Hinweise

Bei Verwendung des API-Triggers darf die kumulative Größe aller Eingabevariablen maximal 8 MB betragen. Wenn die Größe 8 MB überschreitet, führt Application Integration den und Sie erhalten eine Fehlermeldung.

Kontingente und Limits

Informationen zu Kontingenten und Limits finden Sie unter Kontingente und Limits.

Nächste Schritte