bldinit Google Drive Rest API

The google_drive-rest API from bldinit — 5 operation(s) for google_drive-rest.

GitHub OpenAPI

Operations 9

GET /api/v1/google_drive/files 파일 목록 조회 (앱이 만든 파일만 — drive.file scope) #
POST /api/v1/google_drive/files 파일 메타데이터 생성 (write) #
GET /api/v1/google_drive/files/{fileId} 파일 메타데이터 조회 #
PATCH /api/v1/google_drive/files/{fileId} 파일 메타데이터 업데이트 (write — soft delete trigger 포함) #
DELETE /api/v1/google_drive/files/{fileId} 파일 영구 삭제 (write — irreversible!) #
POST /api/v1/google_drive/files/{fileId}/copy 파일 복사 (write) #
GET /api/v1/google_drive/files/{fileId}/export Google Doc/Sheet → PDF/CSV 등 형식 변환 (Phase 1 metadata only) #
GET /api/v1/google_drive/files/{fileId}/permissions 파일 공유 권한 목록 #
POST /api/v1/google_drive/files/{fileId}/permissions 파일 공유 권한 부여 (write) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-google-drive-rest-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mcpweave-com-google-drive-rest-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: mcpweave Google Drive Rest API
  description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
  version: '2026-04-27'
tags:
- name: google_drive-rest
paths:
  /api/v1/google_drive/files:
    get:
      tags:
      - google_drive-rest
      summary: 파일 목록 조회 (앱이 만든 파일만 — drive.file scope)
      description: '``q`` (Drive search query) 로 필터:

        - ``name contains ''report''``

        - ``mimeType=''application/pdf''``

        - ``'''' in parents`` (특정 폴더 안)

        - ``trashed=false``

        - ``modifiedTime > ''2026-05-01T00:00:00''``


        ⚠️ **GD-SCOPE-VERIFIED** (dogfood 검증): drive.file scope 격리 정확.

        - mcpweave 가 만든 파일만 보임 (다른 앱이 만든 파일 / 사용자의 일반 Drive 파일 invisible)

        - dogfood 시 이전 Sheets create_spreadsheet 결과만 표시됨 (전체 Drive 의 다른 파일 invisible)

        - ADR-013 storage policy enforce 강력하게 검증


        ⚠️ **fields 명시 권장** (default minimal 응답 = id/name/mimeType 만):

        - ``fields=files(id,name,mimeType,createdTime,modifiedTime,size,owners,version,parents,webViewLink)``

        - rich response 시 version (수정 횟수 추적), permissionId, capabilities 등 노출'
      operationId: google_drive_list_files
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: q
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Q
      - name: pageSize
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Pagesize
      - name: pageToken
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Pagetoken
      - name: fields
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Fields
      - name: orderBy
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Orderby
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    post:
      tags:
      - google_drive-rest
      summary: 파일 메타데이터 생성 (write)
      description: '파일 metadata 생성 (binary upload 는 Phase 2+).


        body:

        {

        "name": "보고서.pdf",

        "mimeType": "application/pdf",

        "parents": [""] // 선택

        }


        ``mimeType="application/vnd.google-apps.folder"`` 면 폴더 생성.


        **Destructive write — Drive 에 새 파일/폴더 생성**.'
      operationId: google_drive_create_file
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/google_drive/files/{fileId}:
    get:
      tags:
      - google_drive-rest
      summary: 파일 메타데이터 조회
      description: '``fields=*`` 또는 ``fields=*,permissions(*)`` 로 풍부한 메타데이터.


        응답 (dogfood 검증 — fields=*):

        - **GD-CAPABILITIES-RICH**: ``capabilities`` 34 boolean field

        (canEdit / canDelete / canShare / canTrash / canCopy / canModifyLabels /

        canMoveItemWithinDrive / canRename / canChangeViewersCanCopyContent 등)

        — cafe24 자동화 시 user 권한 사전 체크 가능.

        - **GD-EXPORT-LINKS-NATIVE**: Google native file (Doc/Sheet/Slide) 의 ``exportLinks``

        7가지 자동 (xlsx / pdf / csv / tsv / ods / zip / html). binary 다운로드 안 거치고

        link 만 share 가능 — Phase 1 의 export_file 한계 우회 가능.

        - ``version``: 누적 update count (dogfood Sheets 작업 8회 → version 8 추적)

        - ``permissions[].permissionDetails[]``: nested permissions

        (permissionType=file/member, inherited flag)

        - ``quotaBytesUsed``: byte 단위 (string)

        - ``isAppAuthorized``: mcpweave 가 만든 file 인지 flag

        - ``clientEncryptionDetails`` / ``linkShareMetadata.securityUpdateEnabled`` (E2EE / 2021 보안 업데이트)'
      operationId: google_drive_get_file
      parameters:
      - name: fileId
        in: path
        required: true
        schema:
          type: string
          title: Fileid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: fields
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Fields
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    patch:
      tags:
      - google_drive-rest
      summary: 파일 메타데이터 업데이트 (write — soft delete trigger 포함)
      description: '파일 메타 patch (PATCH).


        Soft delete pattern: body 에 ``{"trashed": true}`` 보내면 휴지통으로 이동.

        ``delete_file`` 의 영구 삭제와 다름 — recoverable.


        검증 시 ``get_file`` 으로 확인:

        - ``trashed: true`` + ``explicitlyTrashed: true``

        - ⚠️ **GD-TRASHED-METADATA-FIX1** (dogfood 발견): drive.file scope 에서는

        ``trashedTime`` / ``trashingUser`` 필드 응답에 미포함 (전체 ``drive`` scope

        에서만 노출되거나 fields 명시 필요).


        다른 patchable 필드: name (rename) / description / starred / parents / properties.'
      operationId: google_drive_update_file
      parameters:
      - name: fileId
        in: path
        required: true
        schema:
          type: string
          title: Fileid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    delete:
      tags:
      - google_drive-rest
      summary: 파일 영구 삭제 (write — irreversible!)
      description: '⚠️ **GD-DUAL-DELETE** (dogfood 검증):

        - **delete_file** (이 op): 204 No Content. **영구 삭제, 복구 불가**.

        - **update_file ``trashed=true``**: soft delete. 휴지통으로 이동, 30일 후 자동 hard delete.


        의미적으로 두 op 다르지만 mcpweave wrapper 의 destructive marking 은 같음.

        영구 삭제 (이 op) 가 더 위험하지만 elicitation 추가 보호 X — cross-cutting

        review 후보 (ADR-028 destructive op confirmation policy 참조).


        **권장**: 사용자 의도 명확하지 않은 경우 ``update_file`` + ``trashed=true``

        먼저 사용 (recoverable).'
      operationId: google_drive_delete_file
      parameters:
      - name: fileId
        in: path
        required: true
        schema:
          type: string
          title: Fileid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: confirmation_token
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'ADR-030: required for irreversible op. First call returns token.'
          title: Confirmation Token
        description: 'ADR-030: required for irreversible op. First call returns token.'
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/google_drive/files/{fileId}/copy:
    post:
      tags:
      - google_drive-rest
      summary: 파일 복사 (write)
      operationId: google_drive_copy_file
      parameters:
      - name: fileId
        in: path
        required: true
        schema:
          type: string
          title: Fileid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/google_drive/files/{fileId}/export:
    get:
      tags:
      - google_drive-rest
      summary: Google Doc/Sheet → PDF/CSV 등 형식 변환 (Phase 1 metadata only)
      description: 'Google native 파일 (Doc/Sheet/Slide) 을 다른 형식으로 export.


        ``mimeType`` query 필수:

        - ``application/pdf`` — Google Doc / Sheet / Slide 모두

        - ``text/csv`` — Sheet → CSV

        - ``text/tab-separated-values`` — Sheet → TSV

        - ``application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`` — Sheet → xlsx

        - ``application/vnd.openxmlformats-officedocument.wordprocessingml.document`` — Doc → docx

        - ``application/zip`` — Slide → zip 이미지


        ⚠️ **GD-EXPORT-PHASE1** (dogfood 검증): 응답 ``data: null``, status 200.

        실제 binary 처리는 **Phase 2+** (mcpweave 가 binary upload/download 미지원).


        ⚠️ **GD-EXPORT-FIX1** 후보: 200 OK + null 응답이 misleading. consumer 가

        export 가 동작했다고 오해 가능. Phase 2 에서 501 Not Implemented 또는

        명시적 ``not_implemented: true`` flag 권장.


        ✅ **GD-EXPORT-LINKS-NATIVE 우회**: ``get_file?fields=*`` 응답의

        ``exportLinks`` 에 7가지 형식 URL 자동 노출. binary 다운로드 안 거치고

        link 만 share 가능 — Phase 1 한계의 실용적 우회.'
      operationId: google_drive_export_file
      parameters:
      - name: fileId
        in: path
        required: true
        schema:
          type: string
          title: Fileid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: mimeType
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mimetype
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/google_drive/files/{fileId}/permissions:
    get:
      tags:
      - google_drive-rest
      summary: 파일 공유 권한 목록
      operationId: google_drive_list_permissions
      parameters:
      - name: fileId
        in: path
        required: true
        schema:
          type: string
          title: Fileid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
    post:
      tags:
      - google_drive-rest
      summary: 파일 공유 권한 부여 (write)
      description: 'body:

        {

        "type": "user", // user / group / domain / anyone

        "role": "reader", // reader / commenter / writer / owner

        "emailAddress": "x@example.com"

        }


        sendNotificationEmail (query, 기본 true): 공유 알림 이메일 발송 여부.


        ⚠️ **GD-OWNER-DOWNGRADE** (dogfood 발견): owner 본인에게 reader/writer 추가

        시도 시 **silent reject** + 기존 owner 권한 응답. error 가 아닌 200 OK 응답이라

        consumer 가 다운그레이드 적용됐다고 오해 가능. role 변경은 별도

        ``permissions.update`` (Phase 2+) 사용 필요.


        **Destructive write — 공유 권한 영구 추가**.'
      operationId: google_drive_create_permission
      parameters:
      - name: fileId
        in: path
        required: true
        schema:
          type: string
          title: Fileid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: sendNotificationEmail
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Sendnotificationemail
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)