Google Drive 파일 목록¶

Google Drive 파일 목록 스킬은 Google Drive에서 파일 목록을 조회합니다. 특정 폴더 내 파일, 검색 쿼리, 정렬, 페이지네이션을 지원합니다.

설정 방법¶

1. 스킬 노드 추가¶

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

2. Google Drive 파일 목록 스킬 선택¶

우측 패널의 스킬 탭에서 Google Drive 파일 목록을 선택합니다.

3. Google OAuth 인증 연결¶

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

4. 파라미터 입력¶

설정 탭에서 폴더 ID, 검색 쿼리 등을 입력합니다. {{를 입력하면 변수 셀렉터가 나타납니다.

파라미터¶

파라미터	필수	설명
folder_id		조회할 폴더 ID. 미지정 시 내 드라이브 전체 검색
query		Google Drive 검색 쿼리 (예: `name contains '보고서'`, `mimeType='application/pdf'`)
page_size		한 페이지당 결과 수. 기본: `20`, 최대: `100`
order_by		정렬 기준 (`name`, `modifiedTime`, `createdTime`, `folder`). 기본: `modifiedTime desc`
page_token		다음 페이지 토큰 (페이지네이션용)

인증 정보¶

Google OAuth 인증이 필요합니다.

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

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

출력¶

{
  "success": true,
  "data": {
    "files": [
      {
        "id": "1a2b3c4d5e6f7g8h9i0j",
        "name": "매출_보고서_2026.xlsx",
        "mime_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
        "size": 1048576,
        "created_time": "2026-03-01T09:00:00Z",
        "modified_time": "2026-03-15T14:30:00Z",
        "web_view_link": "https://drive.google.com/file/d/1a2b3c4d5e6f7g8h9i0j/view"
      }
    ],
    "total_count": 15,
    "next_page_token": "abc123nextpage"
  }
}

출력 참조¶

{{ $('skill_1').data_content.result.files }}              → 파일 목록 배열
{{ $('skill_1').data_content.result.files[0].id }}        → 첫 번째 파일 ID
{{ $('skill_1').data_content.result.files[0].name }}      → 첫 번째 파일명
{{ $('skill_1').data_content.result.total_count }}         → 전체 파일 수
{{ $('skill_1').data_content.result.next_page_token }}    → 다음 페이지 토큰

사용 예시¶

특정 폴더의 PDF 파일 검색¶

지정 폴더에서 PDF 파일만 조회합니다.

파라미터	값
folder_id	`1a2b3c4d5e6f`
query	`mimeType='application/pdf'`
order_by	`modifiedTime desc`

이름으로 파일 검색 후 다운로드¶

파일명에 특정 키워드가 포함된 파일을 찾아 후속 다운로드 스킬에 전달합니다.

파라미터	값
query	`name contains '{{ $('trigger').data_content.keyword }}'`
page_size	`10`

참고¶

query는 Google Drive API의 검색 쿼리 문법을 따릅니다.
이름 검색: name contains '키워드'
MIME 타입: mimeType='application/pdf'
수정일: modifiedTime > '2026-01-01T00:00:00'
복합 조건: name contains '보고서' and mimeType='application/pdf'
next_page_token이 반환되면 추가 결과가 있다는 의미입니다. 이 값을 page_token에 전달하여 다음 페이지를 조회합니다.
folder_id 미지정 시 내 드라이브 전체에서 검색합니다.