Google Drive 파일 다운로드¶

Google Drive 파일 다운로드 스킬은 Google Drive에서 파일을 다운로드합니다. 다운로드된 파일은 storage:// 참조로 반환되며, 후속 스킬에서 바로 사용할 수 있습니다.

설정 방법¶

1. 스킬 노드 추가¶

캔버스에서 이전 노드의 + 버튼을 클릭하고 스킬 노드를 추가합니다.

2. Google Drive 파일 다운로드 스킬 선택¶

우측 패널의 스킬 탭에서 Google Drive 파일 다운로드를 선택합니다.

3. Google OAuth 인증 연결¶

인증 탭에서 등록된 Google OAuth 인증 정보를 선택합니다. 미등록 시 새 인증 추가를 클릭하여 Google 계정을 연동합니다.

4. 파라미터 입력¶

설정 탭에서 파일 ID 등을 입력합니다. {{를 입력하면 변수 셀렉터가 나타납니다.

파라미터¶

파라미터	필수	설명
file_id	O	Google Drive 파일 ID
export_format		Google 문서 내보내기 형식 (예: `pdf`, `xlsx`, `csv`, `docx`, `pptx`). 일반 파일은 무시됨

인증 정보¶

Google OAuth 인증이 필요합니다.

항목	설명
access_token	Google OAuth 액세스 토큰 (자동 갱신)
refresh_token	토큰 갱신을 위한 리프레시 토큰

Google 계정 연동 시 Google Drive 읽기 권한이 필요합니다.

출력¶

{
  "success": true,
  "data": {
    "file_path": "storage://s3/workflow-files/run_abc123/downloaded_report.pdf",
    "file_name": "downloaded_report.pdf",
    "mime_type": "application/pdf",
    "size": 2097152
  }
}

출력 참조¶

{{ $('skill_1').data_content.result.file_path }}   → storage:// 파일 참조
{{ $('skill_1').data_content.result.file_name }}   → 파일명
{{ $('skill_1').data_content.result.mime_type }}    → MIME 타입
{{ $('skill_1').data_content.result.size }}         → 파일 크기 (바이트)

사용 예시¶

Drive 파일을 다운로드하여 이메일 첨부¶

Google Drive의 파일을 다운로드한 후 이메일에 첨부하여 전송합니다.

파라미터	값
file_id	`{{ $('trigger').data_content.file_id }}`

Google Sheets를 Excel로 내보내기¶

Google Sheets 문서를 xlsx 형식으로 다운로드합니다.

파라미터	값
file_id	`{{ $('skill_list').data_content.result.files[0].id }}`
export_format	`xlsx`

참고¶

다운로드된 파일은 storage:// 형식으로 S3에 저장되며, 후속 스킬(이메일 전송, 파일 읽기 등)에서 바로 사용할 수 있습니다.
export_format은 Google Docs, Sheets, Slides 등 Google 문서 형식에만 적용됩니다. 일반 파일(PDF, 이미지 등)은 원본 그대로 다운로드됩니다.
Google Sheets 내보내기 지원 형식: xlsx, csv, pdf, ods, tsv.
Google Docs 내보내기 지원 형식: docx, pdf, txt, html, odt.