Google Drive 파일 관리¶

Google Drive 파일 관리 스킬은 Google Drive의 파일을 관리합니다. 이동(move), 이름 변경(rename), 복사(copy), 삭제(delete), 공유(share) 작업을 지원합니다.

설정 방법¶

1. 스킬 노드 추가¶

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

2. Google Drive 파일 관리 스킬 선택¶

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

3. Google OAuth 인증 연결¶

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

4. 파라미터 입력¶

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

파라미터¶

파라미터	필수	설명
file_id	O	대상 파일 ID
action	O	수행할 작업 (`move`, `rename`, `copy`, `delete`, `share`)
new_name		새 파일명 (`rename`, `copy` 시 사용)
target_folder_id		이동/복사 대상 폴더 ID (`move`, `copy` 시 사용)
share_email		공유 대상 이메일 (`share` 시 필수)
share_role		공유 권한 (`reader`, `writer`, `commenter`). 기본: `reader`

인증 정보¶

Google OAuth 인증이 필요합니다.

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

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

출력¶

move / rename / copy¶

{
  "success": true,
  "data": {
    "file_id": "1a2b3c4d5e6f7g8h9i0j",
    "file_name": "보고서_최종.pdf",
    "action": "rename",
    "web_view_link": "https://drive.google.com/file/d/1a2b3c4d5e6f7g8h9i0j/view"
  }
}

delete¶

{
  "success": true,
  "data": {
    "file_id": "1a2b3c4d5e6f7g8h9i0j",
    "action": "delete",
    "deleted": true
  }
}

{
  "success": true,
  "data": {
    "file_id": "1a2b3c4d5e6f7g8h9i0j",
    "action": "share",
    "shared_with": "team@example.com",
    "role": "writer",
    "share_link": "https://drive.google.com/file/d/1a2b3c4d5e6f7g8h9i0j/view?usp=sharing"
  }
}

출력 참조¶

{{ $('skill_1').data_content.result.file_id }}        → 파일 ID
{{ $('skill_1').data_content.result.action }}          → 수행된 작업
{{ $('skill_1').data_content.result.web_view_link }}   → 웹 뷰 링크 (move/rename/copy)
{{ $('skill_1').data_content.result.deleted }}          → 삭제 여부 (delete)
{{ $('skill_1').data_content.result.share_link }}       → 공유 링크 (share)

사용 예시¶

처리 완료 파일을 아카이브 폴더로 이동¶

워크플로우 처리가 완료된 파일을 아카이브 폴더로 이동합니다.

파라미터	값
file_id	`{{ $('skill_download').data_content.result.file_id }}`
action	`move`
target_folder_id	`1a2b3c_archive_folder`

보고서를 팀원에게 공유¶

생성된 보고서를 특정 이메일로 공유합니다.

파라미터	값
file_id	`{{ $('skill_upload').data_content.result.file_id }}`
action	`share`
share_email	`{{ $('trigger').data_content.manager_email }}`
share_role	`writer`

참고¶

copy 작업 시 new_name을 지정하지 않으면 원본 파일명에 "사본"이 붙습니다.
delete 작업은 파일을 휴지통으로 이동합니다 (영구 삭제가 아님).
share 작업 시 대상 사용자에게 공유 알림 이메일이 발송됩니다.
move 작업 시 원본 폴더에서 파일이 제거되고 대상 폴더로 이동합니다.