구글 드라이브
Google Drive 파일을 가져오는 노드입니다.
설명
Google Drive 노드는 구글 계정의 드라이브 파일을 탐색하고, 선택한 파일을 캔버스로 가져올 수 있는 노드입니다.
파일 피커 모달에서 폴더 탐색, 검색, 파일 타입 필터, 다중 선택이 가능하며, 선택한 파일은 백엔드에서 다운로드하여 S3에 업로드한 뒤 다음 노드로 전달됩니다.
구글 계정 연동
사용하려면 먼저 구글 계정을 연동해야 합니다.
- 노드를 캔버스에 추가합니다
- 구글 로그인하여 연결하기 버튼을 클릭합니다
- 구글 계정 로그인 창에서 계정을 선택합니다
- AI Canvas의 Google Drive 접근 권한을 허용합니다
- 연동이 완료되면 파일 피커 모달을 사용할 수 있습니다
포트 구성
입력 포트
없음
출력 포트
- 데이터셋: 가져온 Google Drive 파일 데이터
속성
최대 결과 수
파일 피커에서 가져올 파일의 최대 개수를 설정합니다. (기본값: 1,000)
시간대
파일 날짜/시간 표시에 사용할 시간대를 선택합니다. (예: KST)
폴더 제외
파일 목록에서 폴더를 제외할지 여부를 설정합니다.
파일 피커
노드를 클릭하면 파일 피커 모달이 열립니다. 다음 기능을 제공합니다.
폴더 탐색
- 폴더를 클릭하면 해당 폴더 내부로 이동합니다
- 상단 breadcrumb으로 현재 경로를 확인하고 상위 폴더로 돌아갈 수 있습니다
검색
- 상단 검색창에서 파일명으로 검색할 수 있습니다
정렬
- 수정일순 (기본값): 최근 수정된 파일이 먼저 표시됩니다
- 이름순: 파일명 알파벳 순서로 정렬됩니다
파일 타입 필터
지원하는 파일 타입별로 필터링할 수 있습니다:
| 파일 타입 | 포맷 |
|---|---|
| Google Docs | 구글 문서 |
| Google Sheets | 구글 스프레드시트 |
| Google Slides | 구글 프레젠테이션 |
.pdf | |
| Word | .docx |
| PowerPoint | .pptx, .ppt |
| Excel | .xlsx, .xls |
다중 선택
- 체크박스로 여러 파일을 동시에 선택할 수 있습니다
- 전체 선택 체크박스를 사용할 수 있습니다
- 오른쪽 패널에서 선택한 파일 목록을 확인할 수 있습니다
사용 방법
- 노드를 캔버스에 추가합니다
- 구글 로그인하여 연결하기 버튼을 클릭해 구글 계정을 연동합니다
- 노드를 클릭하여 파일 피커 모달을 엽니다
- 폴더를 탐색하거나 검색하여 원하는 파일을 선택합니다
- 속성에서 최대 결과 수와 시간대를 설정합니다
- 실행하기 버튼을 클릭합니다
- 출력 포트에서 가져온 파일 데이터를 확인할 수 있습니다
예제
주의사항
계정 연동 필수
Google Drive 노드를 사용하려면 구글 계정 연동이 필요합니다.
파일 처리 방식
선택한 파일은 백엔드에서 다운로드하여 S3에 업로드한 뒤 다음 노드로 전달됩니다. 파일 크기에 따라 처리 시간이 달라질 수 있습니다.