Google BigQuery, Gmail 및 검색 연동: AI Flowi Workflow
Google BigQuery, Gmail 및 검색 연동을 다루는 google 카테고리에는 2026년 10월 9일에 내보낸 AI Flowi Workflow 1.9.2 카탈로그 기준으로 정확히 7개의 컴포넌트가 있습니다. 이 중 5개는 BigQuery SQL, Gmail 불러오기, OAuth 토큰 생성, 2개의 검색 API를 다룹니다. 나머지 2개는 아래 목록에서 참고 문서를 안내하는 생성형 AI 컴포넌트입니다.
Google 연동의 사용량과 비용은 요금제 가격 및 워크플로 비용 가이드를 확인하세요.
공식 출처: BigQuery 문서, Gmail API 문서
BigQuery, Gmail, OAuth 및 검색 인터페이스는 카탈로그에 문서화되어 있으며, Ai Flowi의 운영 환경 테스트는 거치지 않았습니다.
별도의 Google Workspace 컴포넌트 계열은 기존 Docs, Drive, Slides 및 Sheets 연동 가이드를 참고하세요.
Google 카테고리의 7개 항목 전체
모델 이외의 5개 행에는 필수로 표시된 모든 입력이 포함되어 있습니다. 인증 정보 필드는 컴포넌트마다 다르며, 이 5개 항목 중 어느 것도 google_account 또는 google_connection_id를 명시하지 않습니다.
출처: Google 카테고리 카탈로그. 이 개수는 google 카테고리에만 해당하며, 별도의 Docs, Drive, Sheets, Slides 및 다른 제공업체 카테고리는 제외합니다. 작은 화면에서는 초점을 맞출 수 있는 각 표 안에서 가로 스크롤을 사용하세요.
| 컴포넌트 | 기능 | 필수 입력과 인증 정보 필드 |
|---|---|---|
| BigQuery | 카탈로그 설명: “Google BigQuery에서 SQL 쿼리를 실행합니다.” | service_account_json_file (파일 형식 인증 정보); query (str; 허용 유형: Message). |
| Gmail Loader | 카탈로그 설명: “제공된 인증 정보를 사용해 Gmail에서 이메일을 불러옵니다.” | json_string (str 형식 인증 정보); label_ids 및 max_results (str; 허용 유형: Message). |
| Google OAuth Token | 카탈로그 설명: “Google OAuth 토큰이 포함된 JSON 문자열을 생성합니다.” | oauth_credentials (파일 형식 인증 정보); scopes (str; 허용 유형: Message). |
| Google Search API | 카탈로그 설명: “Google Search API를 호출하고 결과를 DataFrame으로 반환합니다.” | google_api_key (str 형식 인증 정보); google_cse_id (str); k (int). |
| Google Serper API | 카탈로그 설명: “Serper.dev Google Search API를 호출합니다.” | serper_api_key (str 형식 인증 정보); k (int). |
| Google Generative AI | 두 생성형 AI 컴포넌트 모두 모델 제공업체와 변수를 참고하세요. | |
| Google Generative AI Embeddings | ||
모델 이외의 컴포넌트 5개의 출력 포트
BigQuery와 두 검색 컴포넌트는 Table 출력을 제공합니다. Gmail Loader와 Google OAuth Token은 JSON 출력을 제공합니다. OAuth 설명에서 JSON 문자열이라고 표현하더라도 내보내기 파일의 포트 유형이 바뀌는 것은 아닙니다.
| 컴포넌트 | 출력 표시 이름 | 포트 이름 | 유형 |
|---|---|---|---|
| BigQuery | Query Results | query_results | Table |
| Gmail Loader | JSON | data | JSON |
| Google OAuth Token | Output | output | JSON |
| Google Search API | Results | results | Table |
| Google Serper API | Results | results | Table |
선택한 컴포넌트의 입력에 인증 정보 지정
연결 가이드는 공통 인증 정보 기능을 설명하며, Google Connections 설정은 별도의 Workspace 계열을 다룹니다. 이 5개 컴포넌트는 아래의 각 전용 필드로 설정합니다.
- BigQuery: 서비스 계정 JSON 파일을
service_account_json_file에, SQL을query에 입력합니다. 유일한 선택 입력은clean_query(bool)입니다. 쿼리 재작성 기능에 의존하기 전에 동작을 확인합니다. - Gmail Loader: 인증 정보 문자열을
json_string에 입력한 뒤label_ids와max_results를 설정합니다. 두 필드는 내보내기 파일에서 문자열 유형으로 정의되어 있으며, 3개 입력 모두 필수입니다. 선택 입력이나 인증 정보 JSON 스키마는 명시되어 있지 않습니다. - Google OAuth Token: 인증 정보 파일을
oauth_credentials에, 접근 범위 텍스트를scopes에 입력합니다. 입력은 이 2개뿐이며, 내보내기 파일에는 접근 범위 구분자, 인증 정보 파일 스키마, 승인 절차가 제공되지 않습니다. - Google Search API: 제공업체 키를
google_api_key에, 검색 엔진 식별자를google_cse_id에, 정수를k에 입력합니다. 검색어는 선택 입력인input_value로 전달합니다. 이 필드는 Message를 허용하는 str 유형입니다. - Google Serper API: Serper.dev 키를
serper_api_key에 입력하고 필수 입력인k(int)를 설정합니다. 검색어는 선택 입력인input_value(str; 허용 유형: Message)에 입력합니다. 이 인증 정보는 Serper.dev의 것이므로 해당 제공업체에서 발급받습니다.
테스트 데이터를 사용하고 선택한 계정의 리소스 권한을 확인하세요. 다른 노드를 연결하기 전에 반환된 Table 또는 JSON을 살펴봅니다. 공개 워크플로 예시에 인증 정보 파일, 인증 정보 문자열, OAuth 출력을 포함하지 마세요.
모델 이외의 Google 컴포넌트를 사용하는 설계 3가지
아래 아이디어는 설정 실습을 위한 제안입니다. 다운로드할 수 있는 워크플로나 제공업체에서 실제로 반환받아 확인한 결과는 첨부되어 있지 않습니다.
1. 범위를 제한한 BigQuery 보고서 확인 — 운영 환경 미검증
BigQuery에 서비스 계정 파일과 검토한 SQL 쿼리를 설정합니다. 쿼리는 필요한 테스트 행으로 범위를 제한합니다. 이후 Table과 호환되는 처리 단계를 선택하기 전에 query_results를 Table 데이터로 확인합니다. 본인의 Google 계정에서 쿼리 권한과 제공업체 사용량을 검증합니다.
2. 라벨이 지정된 소규모 Gmail 샘플 불러오기 — 운영 환경 미검증
Gmail Loader의 json_string에 테스트 계정 인증 정보를 입력하고, 원하는 label_ids와 작은 max_results 값을 문자열로 입력합니다. 후속 단계에 필드를 매핑하기 전에 data JSON 출력을 확인해 이메일 구조를 파악합니다. 편집기에서 라벨 구문과 결과 개수 처리 방식을 검증합니다.
3. 검색어 하나에 대한 두 검색 응답 비교 — 운영 환경 미검증
Google Search API와 Google Serper API를 각각 실행합니다. input_value에는 같은 검색어를 입력하고, 의도한 k 값도 같게 설정합니다. 각 제공업체의 전용 키를 설정하고, 필요한 경우 Google Search 검색 엔진 ID도 설정합니다. 워크플로에 사용할 제공업체를 선택하기 전에 두 results Table을 확인합니다. 설정이 같다고 해서 검색 범위나 순위까지 같다고 볼 수는 없습니다.
Google 카테고리의 제한사항과 인터페이스 차이는 무엇인가요?
- 이 인터페이스에는 저장된 Workspace 연결이 명시되어 있지 않습니다. 모델 이외의 5개 컴포넌트는 모두 공통 계정 선택기를 제공하지 않습니다. 카탈로그에는 해당 연결을 서비스 계정 파일, Gmail 인증 정보 문자열, OAuth 파일, 검색 API 키와 연결하는 방법이 없습니다.
- Gmail 불러오기는 이메일 전송 기능이 아닙니다. 이 카테고리에는 Gmail 전송, 답장, 삭제, 받은편지함 트리거 항목이 없습니다. 인증 정보 JSON 구조, 라벨 구분자, 페이지네이션, 최대 결과 개수도 제공되지 않습니다.
- OAuth와 Gmail의 연결은 검증되지 않았습니다. Google OAuth Token은 JSON을 출력하지만 Gmail Loader는 허용 유형 목록이 비어 있는 str 인증 정보 필드를 요구합니다. 내보내기 파일만으로 직접적인 호환성, 인증 정보 갱신 동작, 완전한 인증 절차를 확인할 수는 없습니다.
- 쿼리 정리는 문서화된 SQL 안전장치가 아닙니다. BigQuery에는 선택 입력인
clean_query가 있지만 재작성 규칙, 매개변수 바인딩 입력, 쿼리 시간 제한, 읽기 전용 강제 적용은 명시되어 있지 않습니다. 데이터에 쿼리를 실행하기 전에 SQL과 권한을 검토합니다. - 검색 실행 시 적용되는 제한값이 명시되어 있지 않습니다. 두 검색 컴포넌트 모두 정수형
k를 필수로 요구하고 검색어 입력을 선택 사항으로 표시합니다. 이 표시만으로 검색어 없이 유용한 검색이 가능하다고 볼 수는 없습니다. 결과 상한, 페이지네이션, 재시도, 할당량, 오류 형식도 제공되지 않습니다. - 출력 이름만으로 행 스키마가 정의되지는 않습니다. Google Search API 설명에는 DataFrame 결과라고 되어 있지만 내보내기 파일의 포트 유형은 Table입니다. BigQuery와 Serper도 열 정의 없이 Table을 제공하므로, 후속 단계에서 사용할 필드를 매핑하기 전에 실제 출력을 확인합니다.