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 Kundeninformationen empfängt, finden Sie in der Anleitung zur API-Ausführung.

API-Trigger hinzufügen

Führen Sie die folgenden Schritte aus, um einen API-Trigger hinzuzufügen:

Rufen Sie in der Google Cloud Console die Seite Application Integration auf.
Zu Application Integration
Klicken Sie im Navigationsmenü auf Integrationen.
Auf der Seite Integrationsliste werden alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.
Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Integration 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.
  Hinweis: Im Drop-down-Menü Regionen werden nur die in Ihrem Google Cloud-Projekt bereitgestellten Regionen aufgeführt. Klicken Sie zum Bereitstellen einer neuen Region auf Region aktivieren. Weitere Informationen finden Sie unter Neue Region aktivieren.
3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Details des Dienstkontos einer Integration jederzeit im Bereich Integrationsübersicht in der Symbolleiste für Integrationen ändern oder aktualisieren.
  Hinweis: Die Option zum Auswählen eines Dienstkontos wird nur angezeigt, wenn Sie die Integrationsverwaltung für die ausgewählte Region aktiviert haben.
4. Klicken Sie auf Erstellen.
Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.
Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger, um die Liste der verfügbaren Trigger aufzurufen.
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, für die ein API-Trigger konfiguriert ist, können Sie diesen Trigger mit der Methode projects.locations.integrations.execute von jeder Anwendung aus aufrufen. Mit dieser Methode wird die Ausführung im synchronen Modus ausgelöst.

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://LOCATION-integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-:execute"

Ersetzen Sie Folgendes:

TRIGGER_NAME: Der Name des API-Triggers in Ihrer 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 mit dem API-Trigger test_API_1 im Google Cloud-Projekt demo-project aufgerufen:

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 die Integration nicht aus und Sie erhalten einen Fehler.

Kontingente und Limits

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