Consulta i connettori supportati per Application Integration.

Trigger API

I trigger API vengono utilizzati per richiamare direttamente le esecuzioni per le integrazioni. I trigger API possono essere utilizzati in modalità sincrona o asincrona.

Puoi impostare il payload di richiesta e risposta per l'attivatore API creando variabili nella tua integrazione. Per informazioni su come creare un'integrazione con un trigger API che riceve richieste API per il recupero delle informazioni sui clienti, consulta il tutorial fulfillment API.

Aggiungi un trigger API

Per aggiungere un trigger attivatore API, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Application Integration (Integrazione di applicazioni).

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrations (Integrazioni)

   Viene visualizzata la pagina Elenco delle integrazioni che elenca tutte le integrazioni disponibili nel progetto Google Cloud.

3. Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.

   Se stai creando una nuova integrazione:

   1. Inserisci un nome e una descrizione nel riquadro Crea integrazione.
   2. Seleziona una regione per l'integrazione.
      Nota:nel menu a discesa Regioni sono elencate solo le regioni di cui è stato eseguito il provisioning nel tuo progetto Google Cloud. Per eseguire il provisioning di una nuova regione, fai clic su Abilita regione. Per ulteriori informazioni, consulta Attivare una nuova regione.
   3. Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli di un account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo integrazione nella barra degli strumenti di integrazione.
      Nota: l'opzione per selezionare un account di servizio viene visualizzata solo se hai attivato la governance di integrazione per la regione selezionata.
   4. Fai clic su Crea.

   L'integrazione viene aperta nell'editor di integrazione.

4. Nella barra di navigazione dell'editor di integrazione, fai clic su Attivatori per visualizzare l'elenco degli attivatori disponibili.
5. Fai clic sull'elemento attivatore API e posizionalo nel designer.

Configura un trigger API

Fai clic sull'elemento Trigger API nell'editor di integrazione per visualizzare il riquadro di configurazione dell'attivatore.

Il riquadro di configurazione mostra l'ID trigger, ovvero un ID generato automaticamente nel formato api_trigger/TRIGGER_NAME. Non sono necessarie ulteriori configurazioni per questo trigger.

Nota: puoi avere più di un trigger API nell'integrazione. A ogni trigger API viene assegnato un ID trigger univoco.

Richiama il trigger API da un'applicazione

Dopo aver pubblicato un'integrazione in cui è configurato un trigger API, puoi utilizzare il metodo projects.locations.integrations.execute per richiamarlo da qualsiasi applicazione. Questo metodo attiva l'esecuzione in modalità sincrona.

Sintassi

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"

Sostituisci quanto segue:

• TRIGGER_NAME: il nome del trigger API nella tua integrazione.
• PROJECT_ID: l'ID del tuo progetto Google Cloud.
• LOCATION: la località del tuo progetto Google Cloud.

Esempio

L'esempio seguente richiama un'integrazione nella regione us-east1 contenente il trigger dell'API test_API_1 nel progetto Google Cloud demo-project:

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"

Considerazioni

Quando utilizzi il trigger API, le dimensioni cumulative di tutte le variabili di input possono essere al massimo di 8 MB. Se le dimensioni superano gli 8 MB, Application Integration non esegue l'integrazione e verrà visualizzato un errore.