bldinit Google Docs Rest API

The google_docs-rest API from bldinit — 3 operation(s) for google_docs-rest.

GitHub OpenAPI

Operations 3

GET /api/v1/google_docs/v1/documents/{documentId} Google Docs 문서 읽기 (구조·텍스트·메타데이터) #
POST /api/v1/google_docs/v1/documents Google Docs 빈 문서 생성 (write) — 내용은 batch_update로 #
POST /api/v1/google_docs/v1/documents/{documentId}:batchUpdate Google Docs 문서 일괄 편집 (write — insertText / replaceAllText 등) #

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-docs-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-docs-rest-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: mcpweave Google Docs Rest API
  description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
  version: '2026-04-27'
tags:
- name: google_docs-rest
paths:
  /api/v1/google_docs/v1/documents/{documentId}:
    get:
      tags:
      - google_docs-rest
      summary: Google Docs 문서 읽기 (구조·텍스트·메타데이터)
      description: '문서 ID로 Google Docs 문서 전체를 읽습니다. 응답에 ``documentId``, ``title``,

        ``body.content[]`` (텍스트 트리), ``revisionId`` 등 포함.


        **사전 준비**:

        1. GCP Console에서 ``Google Docs API`` 활성화 필수.

        2. 자기 GCP OAuth 앱에 ``documents`` 스코프 동의.


        **documentId**: Google Docs URL의 ``/d/{documentId}/edit`` 부분.

        예: ``https://docs.google.com/document/d/1AbCd.../edit`` → ``1AbCd...``


        **텍스트 접근 경로**:

        ``body.content[i].paragraph.elements[j].textRun.content``


        **주요 query 파라미터**:

        - ``suggestionsViewMode``: 제안(tracked change) 표시 방식. 기본 ``DEFAULT_FOR_CURRENT_ACCESS``.

        - ``includeTabsContent``: ``true`` 시 ``tabs[]`` 필드 채움 (legacy ``body`` 대신). 기본 ``false``.


        **응답 주요 필드**: documentId / title / body.content[] /

        revisionId / documentStyle / headers / footers / lists.


        ``revisionId`` 는 이후 ``google_docs_batch_update`` 의 ``writeControl.requiredRevisionId`` 에 사용

        (낙관적 동시성 제어).


        Native pass-through.'
      operationId: google_docs_get_document
      parameters:
      - name: documentId
        in: path
        required: true
        schema:
          type: string
          title: Documentid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: suggestionsViewMode
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Suggestionsviewmode
      - name: includeTabsContent
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Includetabscontent
      - 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_docs/v1/documents:
    post:
      tags:
      - google_docs-rest
      summary: Google Docs 빈 문서 생성 (write) — 내용은 batch_update로
      description: '새 Google Docs 문서를 생성합니다. 응답에 ``documentId`` 포함 — 이후

        ``google_docs_batch_update`` 로 내용 추가.


        > ``create`` 에서 반영되는 필드는 **title 만**. body/headers 등을 body에 포함해도 서버에서 무시.

        > 내용 삽입은 반드시 ``google_docs_batch_update`` 의 ``insertText`` / ``replaceAllText`` 사용.


        **전형 패턴**:

        1. ``google_docs_create_document`` → ``documentId`` 확보

        2. ``google_docs_batch_update`` → ``insertText`` / ``replaceAllText`` 로 내용 삽입


        특정 Drive 폴더에 배치하려면 Drive API ``files.update`` 의 ``parents`` 필드 사용.


        **Destructive write — 새 Drive 파일 생성**.'
      operationId: google_docs_create_document
      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_docs/v1/documents/{documentId}:batchUpdate:
    post:
      tags:
      - google_docs-rest
      summary: Google Docs 문서 일괄 편집 (write — insertText / replaceAllText 등)
      description: 'Google Docs 의 핵심 편집 op. ``requests[]`` 배열에 편집 명령을 담아 원자적으로 적용합니다.

        한 번의 호출로 텍스트 삽입, 치환, 서식 변경, 표 삽입 등을 묶어 처리.


        **원자성**: 요청 중 하나라도 유효하지 않으면 **전체 실패** (부분 적용 없음).


        **주요 request type 예시**:


        텍스트 삽입:

        ```json

        {

        "requests": [

        {"insertText": {"location": {"index": 1}, "text": "안녕하세요\\n"}}

        ]

        }

        ```


        템플릿 치환 (replaceAllText — index 불필요, 가장 안전):

        ```json

        {

        "requests": [

        {"replaceAllText": {"containsText": {"text": "{{고객명}}", "matchCase": true}, "replaceText": "홍길동"}},

        {"replaceAllText": {"containsText": {"text": "{{날짜}}", "matchCase": true}, "replaceText": "2026-06-06"}}

        ]

        }

        ```


        **index shift 주의**: 여러 ``insertText`` 사용 시 앞선 삽입이 이후 index를 밀어냄.

        여러 삽입은 **문서 뒤→앞** 순서로 requests 배열 구성 권장.


        **write quota**: 60 req/user/min — 여러 편집을 한 batchUpdate 호출에 묶어 quota 절감.


        **전체 request type 목록은 Google Docs API 문서 참조**:

        insertText / replaceAllText / deleteContentRange / updateTextStyle /

        updateParagraphStyle / insertTable / insertTableRow / insertInlineImage 등 40+종.


        ``writeControl.requiredRevisionId``: ``google_docs_get_document`` 응답의 ``revisionId`` 사용

        → 낙관적 동시성 제어 (지정된 버전에만 적용).


        **Destructive write** (내용 편집은 버전 히스토리로 복원 가능 — irreversible 아님, ADR-124 §D5).'
      operationId: google_docs_batch_update
      parameters:
      - name: documentId
        in: path
        required: true
        schema:
          type: string
          title: Documentid
      - 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)