Google Drive 파일 업로드

Google Drive 파일 업로드 스킬은 Google Drive에 파일을 업로드합니다. storage:// S3 참조, URL, base64 인코딩 데이터를 입력으로 지원하며, Google 문서 형식으로 변환할 수 있습니다.

---

설정 방법

1. 스킬 노드 추가

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

2. Google Drive 파일 업로드 스킬 선택

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

3. Google OAuth 인증 연결

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

4. 파라미터 입력

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

---

파라미터

파라미터	필수	설명
file	O	업로드할 파일 (storage:// 참조, URL, 또는 base64 데이터)
filename	O	저장할 파일명 (확장자 포함)
folder_id		업로드할 Google Drive 폴더 ID. 미지정 시 내 드라이브 루트
mime_type		파일 MIME 타입 (예: application/pdf). 미지정 시 자동 감지
convert_to		Google 문서 형식으로 변환 (document, spreadsheet, presentation)

---

인증 정보

Google OAuth 인증이 필요합니다.

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

Google 계정 연동 시 Google Drive 파일 관리 권한이 필요합니다.

---

출력

{
  "success": true,
  "data": {
    "file_id": "1a2b3c4d5e6f7g8h9i0j",
    "file_name": "report.pdf",
    "mime_type": "application/pdf",
    "web_view_link": "https://drive.google.com/file/d/1a2b3c4d5e6f7g8h9i0j/view",
    "web_content_link": "https://drive.google.com/uc?id=1a2b3c4d5e6f7g8h9i0j&export=download",
    "size": 1048576
  }
}

출력 참조

{{ $('skill_1').data_content.result.file_id }}           → 파일 ID
{{ $('skill_1').data_content.result.web_view_link }}     → 웹 뷰 링크
{{ $('skill_1').data_content.result.web_content_link }}  → 다운로드 링크

---

사용 예시

생성된 보고서를 Drive에 업로드

파일 쓰기 스킬로 생성한 보고서를 Google Drive 특정 폴더에 업로드합니다.

파라미터	값
file	{{ $('skill_file_write').data_content.result.file_path }}
filename	월간_보고서_2026_03.xlsx
folder_id	1a2b3c4d5e6f

CSV 파일을 Google Sheets로 변환 업로드

파라미터	값
file	{{ $('skill_1').data_content.result.file_path }}
filename	매출_데이터.csv
convert_to	spreadsheet

---

참고

• file은 storage:// S3 참조, HTTP/HTTPS URL, base64 인코딩 데이터를 모두 지원합니다.
• convert_to를 지정하면 업로드 시 Google Docs, Sheets, Slides 형식으로 자동 변환됩니다.
• 업로드된 파일의 file_id는 후속 Google Drive 파일 관리 스킬에서 사용할 수 있습니다.