<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:- Rufen Sie in der Google Cloud Console die Seite Application Integration auf.
- Klicken Sie im Navigationsmenü auf Integrations (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 Verknüpfung erstellen, um eine neue zu erstellen.
Wenn Sie eine neue Integration erstellen, gehen Sie so vor:
- Geben Sie im Bereich Create Integration (Integration erstellen) einen Namen und eine Beschreibung ein.
- Wählen Sie eine Region für die Integration aus.
- 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.
- 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, in der ein API-Trigger konfiguriert ist, können Sie diesen Trigger mit der Methodeprojects.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
- Weitere Informationen zu allen Aufgaben und Triggern
- Weitere Informationen zum Testen und Veröffentlichen einer Integration
- Weitere Informationen zur Fehlerbehandlung
- Ausführungslogs für die Integration