- 가장 기본적인 단계는 웹훅을 보내는 것입니다.
- URL은 고정되어 있으며, 변수는 본문에 넣을 수 있습니다.
- 답변은 추가 조치를 위해 보관되어 있습니다.
- 이 기능을 사용하려면 관리자 권한이 필요합니다.
Google Workspace Studio 워크플로는 Gmail, Drive 또는 Chat 외부의 데이터(예: 주문 상태, 데이터베이스의 숫자 또는 내부 도구의 응답)가 필요할 수 있습니다. 이러한 데이터를 가져오거나 다른 서비스로 정보를 보내려면 단계를 추가할 수 있습니다. 웹훅을 보내세요이는 사용자가 지정한 API 주소로 HTTP 요청을 보냅니다.
해당 요청을 수행하기 위해 Gemini 함수 호출을 구성할 필요는 없습니다. Workspace Studio에서 플로우는 웹훅 단계를 실행하고 응답을 수신합니다. 그런 다음, 필요에 따라 해당 응답을 다른 단계로 전달하여 요약하거나, 데이터를 추출하거나, 결과를 전달할 수 있습니다.
API에 연결하기 전에 필요한 사항
첫 번째 단계는 조직에서 웹훅을 사용할 수 있는지 확인하는 것입니다. 해당 기능은 다음 위치에 있습니다. 제한된 미리보기 기본적으로 비활성화되어 있으며, 관리자가 로그인해야 합니다. 앱 > Google Workspace > Workspace Studio > 웹훅 설정 그리고 해당 조직 단위에 대해 이를 활성화하십시오.
일부 버전에서는 관리자가 연결을 하나로 제한할 수도 있습니다. 허용된 도메인 및 URL 목록스튜디오에 단계가 표시되지만 API와 통신하지 못하는 경우 대상 주소에 권한이 있는지 확인하십시오. 또한 기본적으로 웹훅 관련 작업은 실행 전에 사용자가 단계를 검토하고 확인해야 합니다.
외부 서비스에 접근하려면 해당 서비스의 URL, 지원하는 HTTP 메서드, 그리고 예상하는 데이터 형식을 알아야 합니다. 또한 인증 방식도 확인해야 합니다. 공개 읽기 전용 API는 토큰이나 특수 헤더를 요구하는 비공개 API와 인증 요건이 다릅니다.
Workspace Studio에서 API를 호출하는 방법 (단계별)
입력하다 스튜디오.워크스페이스.구글.com 원하는 트리거를 사용하여 워크플로를 생성합니다. 예를 들어 특정 조건을 충족하는 이메일이 도착했을 때 워크플로가 시작되도록 설정할 수 있습니다. 그런 다음 다음 단계를 따르세요.
- 누르다 단계 추가 그리고 선택하세요 웹훅을 보내세요.
- 입력하세요 전체 URL API의 접두사를 포함하여
https://주소는 고정되어 있어야 합니다. 이 필드는 흐름 변수를 지원하지 않습니다. - HTTP 메서드를 선택하세요. 얻다 데이터를 조회하는 데 사용됩니다. 우편그것들을 보내거나 기록을 남길 수 있습니다. 또한 이용 가능합니다. 삽입, 패치 및 삭제.
- API에 본문이 필요한 경우, 콘텐츠 필드에 본문을 작성하거나 유효 탑재량구글은 수신 서비스에서 JSON 형식을 요구하는 경우 JSON 사용을 권장합니다.
- 만들다 테스트 실행결과를 확인하고 정상적으로 작동하는 것을 검증한 후 워크플로를 활성화하십시오.
시험은 다음 사항을 염두에 두세요. 동작을 수행하세요레코드를 생성하는 POST 요청이나 레코드를 삭제하는 DELETE 요청을 구성하는 경우, 먼저 테스트 환경이나 문제없이 수정할 수 있는 데이터를 사용하십시오.
예시: 외부 도구로 알림 전송
팀에 알림을 생성하는 API가 있다고 상상해 보세요. https://api.ejemplo.com/v1/avisos이 주소는 예시해당 서비스의 코드로 교체해야 합니다. 서비스 설명서에 POST 요청과 JSON 본문을 허용한다고 명시되어 있다면 다음과 같은 내용으로 단계를 구성할 수 있습니다. {"tipo":"nuevo_correo","origen":"Workspace Studio"}.
또한 삽입할 수도 있습니다. 유량 변수 예를 들어 본문에 해당 이메일을 트리거한 이메일의 제목을 포함하려면 Studio의 변수 선택기를 사용하고 결과를 확인하세요. 삽입된 텍스트에 따옴표나 기타 특수 문자가 포함되어 있으면 JSON 형식이 잘못될 수 있습니다. 변수는 콘텐츠에 사용할 수 있지만, URL 필드에 없음.
데이터를 검색해야 하는 경우 GET을 선택하고 필요한 매개변수가 이미 포함된 고정 URL을 입력하십시오. Workspace Studio는 GET 요청 본문에 사용자가 작성한 내용을 무시합니다.
API 응답을 어떻게 처리해야 할까요?
웹훅 단계는 다음을 남깁니다. 서비스 응답을 텍스트로 표시합니다. 이 변수는 후속 단계에서 사용할 수 있습니다. 이 변수를 사용하여 알림을 보내거나, 요약을 작성하거나, AI 단계에 특정 데이터를 추출하도록 요청할 수 있습니다.
예를 들어 API가 주문 상태를 반환하는 경우, 다음 단계에서 해당 상태를 팀에 전달할 수 있습니다. 응답이 포함된 변수를 명시적으로 선택해야 합니다. 후속 단계에서 이전에 발생한 모든 내용을 자동으로 수신하는 것은 아니기 때문입니다. 응답에 의존하는 명령어를 작성하기 전에 반환된 내용을 테스트하는 것이 좋습니다.
API에 인증이나 더 복잡한 로직이 필요한 경우
문서화된 기본 구성은 다음과 같습니다. 웹훅을 보내세요 여기에는 URL, 메서드 및 선택적 본문이 포함됩니다. 통합에서 OAuth 토큰을 획득하거나, 가변 매개변수를 사용하여 URL을 구성하거나, 특정 헤더를 추가하거나, 진행하기 전에 응답을 변환해야 하는 경우 이 단계가 해당 요구 사항을 충족하는지 확인하십시오.
그것이 충분하지 않을 경우, 한 가지 방법은 자체적으로 개발하는 것입니다. Workspace Studio용 사용자 지정 단계 플러그인을 통해. Google Apps Script 구현에서 서비스는 UrlFetchApp 이 기능을 사용하면 외부 API에 요청을 보내고 JSON 응답을 처리할 수 있습니다. 이 솔루션은 개발 및 적절한 권한 구성이 필요하며, 기본 제공 기능에서 이미 처리할 수 있는 간단한 요청에는 필요하지 않습니다.
개인 키를 워크플로의 보이는 필드에 붙여넣거나 공유 URL에 포함시키지 마십시오. Gmail, 채팅 또는 캘린더에서 데이터를 전송하기 전에 외부 서비스가 어떤 정보를 수신할지, 그리고 해당 서비스를 처리할 권한이 있는지 확인하십시오.
웹훅에서 오류를 찾는 방법
연결에 실패하면 탭을 여세요. 활동 해당 흐름의 일부입니다. 여기에서 전체 오류와 대상 서버에서 보낸 응답을 확인할 수 있습니다. 이 정보는 Studio 구성 문제와 API에서 요청이 거부된 경우를 구분하는 데 도움이 됩니다.
- 해당 단계가 나타나지 않습니다: 소속 조직 단위에서 웹훅이 활성화되어 있는지 관리자에게 확인하십시오.
- URL이 차단되었습니다: 사용 중인 버전에 해당 제한 사항이 있는 경우 허용된 주소 목록을 확인하십시오.
- 오류 400: 본문 형식과 API에서 요구하는 필드를 확인하세요.
- 오류 401 또는 403: 서비스에서 요구하는 권한 및 인증 방법을 검토하십시오.
- 오류 429: 대상 API에 대한 요청 제한을 초과했는지 확인하십시오.
- 오류 500: 요청을 받은 서비스의 상태 및 기록을 확인하십시오.
또한 Workspace Studio의 일반적인 제한 사항을 염두에 두십시오. 현재 최대 사용자당 25개의 흐름 y 흐름당 20단계또한, 24시간마다 초기화되는 총 실행 제한이 있습니다. 여러 워크플로가 실행을 중지하는 경우, API 오류로 단정하기 전에 해당 워크플로의 활동 내역을 검토하십시오.
대부분의 간단한 HTTP 연결의 경우 과정은 간단합니다. 웹훅을 활성화하고, 고정 URL과 올바른 메서드를 구성하고, 요청을 테스트한 다음, 응답을 후속 단계에서 사용하면 됩니다. 하지만 통합에 고급 인증이나 코드를 통한 데이터 변환이 필요한 경우에는 사용자 지정 단계를 준비하는 것이 좋습니다.
나는 그의 "괴짜" 관심을 직업으로 바꾼 기술 열광자입니다. 나는 10년 넘게 최첨단 기술을 사용하고 순수한 호기심으로 온갖 프로그램을 만지작거리며 살아왔습니다. 이제 저는 컴퓨터 기술과 비디오 게임을 전공했습니다. 왜냐하면 저는 5년 넘게 기술 및 비디오 게임에 관한 다양한 웹사이트에 글을 쓰고 모든 사람이 이해할 수 있는 언어로 필요한 정보를 제공하려는 기사를 작성해 왔기 때문입니다.
질문이 있으시면 제가 알고 있는 지식은 Windows 운영 체제는 물론 휴대폰용 Android까지 다양합니다. 그리고 저는 여러분을 위한 헌신을 하고 있습니다. 저는 항상 몇 분씩만 시간을 내어 이 인터넷 세계에서 여러분이 가질 수 있는 모든 질문을 해결하도록 도와드릴 의향이 있습니다.