Application Integration에 지원되는 커넥터를 참조하세요.

API 트리거

API 트리거는 통합 실행을 직접 호출하는 데 사용됩니다. API 트리거는 동기 또는 비동기 모드에서 사용될 수 있습니다.

통합에서 변수를 만들어 API 트리거에 대해 요청 및 응답 페이로드를 설정할 수 있습니다. 고객 정보 검색을 위한 API 요청을 수신하는 API 트리거와 통합을 만드는 방법은 API fulfillment 튜토리얼을 참조하세요.

API 트리거 추가

API 트리거 트리거를 추가하려면 다음 단계를 수행합니다.
  1. Google Cloud 콘솔에서 Application Integration 페이지로 이동합니다.

    Application Integration으로 이동

  2. 탐색 메뉴에서 통합을 클릭합니다.

    Google Cloud 프로젝트에서 사용할 수 있는 모든 통합이 나열된 통합 목록 페이지가 나타납니다.

  3. 기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.

    새 통합을 만드는 경우:

    1. 통합 만들기 창에 이름과 설명을 입력합니다.
    2. 통합 리전을 선택합니다.
    3. 통합을 위한 서비스 계정을 선택합니다. 통합 툴바의 통합 요약 창에서 언제든지 통합에 대한 서비스 계정 세부정보를 변경하거나 업데이트할 수 있습니다.
    4. 만들기를 클릭합니다.

    통합 편집기 페이지에서 통합이 열립니다.

  4. 통합 편집기 탐색 메뉴에서 트리거를 클릭하여 사용 가능한 트리거 목록을 확인합니다.
  5. API 트리거 요소를 클릭하여 디자이너에 배치합니다.

API 트리거 구성

통합 편집기에서 API 트리거 요소를 클릭하여 트리거 구성 창을 봅니다.

구성 패널에는 api_trigger/TRIGGER_NAME 형식의 머신 생성 ID인 트리거 ID가 표시됩니다. 이 트리거에는 추가 구성이 필요하지 않습니다.

애플리케이션에서 API 트리거 호출

API 트리거가 구성된 통합을 게시한 후 projects.locations.integrations.execute 메서드를 사용하여 모든 애플리케이션에서 해당 트리거를 호출할 수 있습니다. 이 메서드는 동기 모드에서 실행을 트리거합니다.

구문

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"

다음을 바꿉니다.

  • TRIGGER_NAME: 통합의 API 트리거 이름입니다.
  • PROJECT_ID: Google Cloud 프로젝트의 ID
  • LOCATION: Google Cloud 프로젝트의 위치

예

다음 예시에서는 demo-project Google Cloud 프로젝트에 test_API_1 API 트리거가 포함된 us-east1 리전의 통합을 호출합니다.

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"

고려사항

API 트리거를 사용하는 경우 모든 입력 변수의 누적 크기가 최대 8MB일 수 있습니다. 크기가 8MB를 초과하면 Application Integration에서 통합이 실행되지 않고 오류가 표시됩니다.