Consulta i connettori supportati per Application Integration.

Trigger API

Gli attivatori API vengono utilizzati per invocare 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 nell'integrazione. Per informazioni su come creare un'integrazione con un trigger API che riceve richieste API per il recupero delle informazioni del cliente, consulta il tutorial Completamento API.

Aggiungi un trigger API

Per aggiungere un trigger API, segui questi passaggi:
  1. Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.

    Vai ad Application Integration

  2. Nel menu di navigazione, fai clic su Integrazioni.

    Viene visualizzata la pagina Integrations List (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.
    3. Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli dell'account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo dell'integrazione nella barra degli strumenti di integrazione.
    4. Fai clic su Crea.

    Viene visualizzata l'integrazione nell'editor di integrazione.

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

Configurare un trigger API

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

Nel riquadro di configurazione viene visualizzato l'ID trigger, ovvero un generato automaticamente nel formato api_trigger/TRIGGER_NAME. Non è necessaria alcuna ulteriore configurazione per questo attivatore.

Richiamare l'attivatore API da un'applicazione

Dopo aver pubblicato un'integrazione con un trigger API configurato, puoi utilizzare il metodo projects.locations.integrations.execute per richiamare l'trigger 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://LOCATION-integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-:execute"

Sostituisci quanto segue:

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

Esempio

L'esempio seguente richiama un'integrazione nella regione us-east1 contenente il trigger 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, la dimensione cumulativa di tutte le variabili di input può avere una dimensione massima di 8 MB. Se le dimensioni superano gli 8 MB, l'integrazione delle app non viene eseguita e viene visualizzato un messaggio di errore.

Quote e limiti

Per informazioni su quote e limiti, consulta Quote e limiti.

Passaggi successivi