bldinit Google Forms Rest API

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

GitHub OpenAPI

Operations 5

GET /api/v1/google_forms/v1/forms/{formId} Google Forms 폼 구조 조회 (제목·질문 목록·설정) #
POST /api/v1/google_forms/v1/forms Google Forms 폼 생성 (title만) — 질문 추가는 batch_update 2-step #
POST /api/v1/google_forms/v1/forms/{formId}:batchUpdate Google Forms 폼 일괄 편집 (write — 질문 추가·수정·삭제 등) #
GET /api/v1/google_forms/v1/forms/{formId}/responses Google Forms 응답 목록 조회 (설문 결과 수집) #
GET /api/v1/google_forms/v1/forms/{formId}/responses/{responseId} Google Forms 단일 응답 조회 #

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-forms-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-forms-rest-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: mcpweave Google Forms Rest API
  description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
  version: '2026-04-27'
tags:
- name: google_forms-rest
paths:
  /api/v1/google_forms/v1/forms/{formId}:
    get:
      tags:
      - google_forms-rest
      summary: Google Forms 폼 구조 조회 (제목·질문 목록·설정)
      description: '폼 ID로 Google Forms 폼 전체 구조를 조회합니다. 응답에 ``formId``, ``info.title``,

        ``items[]`` (질문 목록), ``revisionId``, ``responderUri`` 등 포함.


        **사전 준비**:

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

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


        **formId**: Google Forms URL의 ``/d/{formId}/edit`` 부분.

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


        **응답 주요 필드**:

        - ``formId``: 폼 ID

        - ``info.title``: 응답자에게 보이는 제목

        - ``info.documentTitle``: Drive에서 보이는 제목 (읽기 전용)

        - ``items[]``: 질문·섹션 헤더 목록 (questionItem / pageBreakItem 등)

        - ``revisionId``: 현재 리비전 (24h 유효, batchUpdate writeControl 에 사용)

        - ``responderUri``: 응답자 공유용 URL


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

        (낙관적 동시성 제어).


        Native pass-through.'
      operationId: google_forms_get_form
      parameters:
      - name: formId
        in: path
        required: true
        schema:
          type: string
          title: Formid
      - 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)
  /api/v1/google_forms/v1/forms:
    post:
      tags:
      - google_forms-rest
      summary: Google Forms 폼 생성 (title만) — 질문 추가는 batch_update 2-step
      description: '새 Google Forms 폼을 생성합니다. 응답에 ``formId`` 포함 — 이후

        ``google_forms_batch_update`` 로 질문(createItem) 추가.


        > **중요**: ``create`` 에서 반영되는 필드는 **info.title (및 info.documentTitle) 만**.

        > body에 ``items``, ``settings`` 등을 포함해도 서버에서 무시됩니다.

        > 질문 추가는 반드시 ``google_forms_batch_update`` 의 ``createItem`` 사용.


        **전형 패턴**:

        1. ``google_forms_create_form`` → ``formId`` 확보 (title 만 지정)

        2. ``google_forms_batch_update`` → ``createItem`` 요청으로 질문 추가


        **Destructive write — 새 Drive 파일 생성**.'
      operationId: google_forms_create_form
      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_forms/v1/forms/{formId}:batchUpdate:
    post:
      tags:
      - google_forms-rest
      summary: Google Forms 폼 일괄 편집 (write — 질문 추가·수정·삭제 등)
      description: 'Google Forms 의 핵심 편집 op. ``requests[]`` 배열에 편집 명령을 담아 원자적으로 적용합니다.

        한 번의 호출로 질문 추가, 폼 정보 수정, 질문 이동·삭제 등을 묶어 처리.


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


        **주요 request type 예시**:


        질문 추가 (createItem — 단답형):

        ```json

        {

        "requests": [

        {

        "createItem": {

        "item": {

        "title": "성함을 입력해 주세요",

        "questionItem": {

        "question": {

        "required": true,

        "textQuestion": { "paragraph": false }

        }

        }

        },

        "location": { "index": 0 }

        }

        }

        ]

        }

        ```


        객관식 질문 추가 (choiceQuestion):

        ```json

        {

        "requests": [

        {

        "createItem": {

        "item": {

        "title": "만족도를 선택해 주세요",

        "questionItem": {

        "question": {

        "required": true,

        "choiceQuestion": {

        "type": "RADIO",

        "options": [

        {"value": "매우 만족"},

        {"value": "만족"},

        {"value": "보통"},

        {"value": "불만족"}

        ]

        }

        }

        }

        },

        "location": { "index": 1 }

        }

        }

        ]

        }

        ```


        폼 정보 수정 (updateFormInfo):

        ```json

        {

        "requests": [

        {

        "updateFormInfo": {

        "info": { "description": "설문에 참여해 주셔서 감사합니다." },

        "updateMask": "description"

        }

        }

        ]

        }

        ```


        **전체 request type**: createItem / updateFormInfo / updateSettings /

        moveItem / deleteItem / updateItem.


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

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


        ``includeFormInResponse``: true 시 업데이트된 폼 전체를 응답에 포함.


        **Destructive write** (편집은 버전 히스토리로 복원 가능 — irreversible 아님, ADR-124).'
      operationId: google_forms_batch_update
      parameters:
      - name: formId
        in: path
        required: true
        schema:
          type: string
          title: Formid
      - 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_forms/v1/forms/{formId}/responses:
    get:
      tags:
      - google_forms-rest
      summary: Google Forms 응답 목록 조회 (설문 결과 수집)
      description: '설문 폼에 제출된 응답 목록을 조회합니다. 자영업자 고객 설문·피드백 수집의 핵심 op.


        **사전 준비**:

        ``forms.responses.readonly`` 스코프 동의 필요.


        **응답 주요 필드**:

        - ``responses[].responseId``: 응답 ID

        - ``responses[].createTime``: 첫 제출 시각 (RFC3339)

        - ``responses[].lastSubmittedTime``: 최근 제출 시각

        - ``responses[].respondentEmail``: 응답자 이메일 (이메일 수집 설정 시)

        - ``responses[].answers``: 질문별 답변 (map)

        - ``nextPageToken``: 추가 응답이 있을 때 설정 (5000개 이상 시 pagination)


        **filter 사용 예시**:

        - ``"timestamp > 2026-06-01T00:00:00Z"`` — 특정 시각 이후 응답만

        - ``"timestamp >= 2026-06-01T00:00:00Z"`` — 특정 시각 이후(포함) 응답만


        **pagination**: ``nextPageToken`` 이 있으면 ``pageToken`` 파라미터로 다음 페이지 요청.

        filter 와 formId 는 원본 요청과 동일하게 유지.


        Native pass-through.'
      operationId: google_forms_list_responses
      parameters:
      - name: formId
        in: path
        required: true
        schema:
          type: string
          title: Formid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: filter
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Filter
      - 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: 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_forms/v1/forms/{formId}/responses/{responseId}:
    get:
      tags:
      - google_forms-rest
      summary: Google Forms 단일 응답 조회
      description: '특정 응답 ID로 단일 설문 응답을 조회합니다. ``formId`` 와 ``responseId`` 두 경로 파라미터 필요.


        ``responseId`` 는 ``google_forms_list_responses`` 응답의 ``responses[].responseId`` 에서 확인.


        **응답 주요 필드**:

        - ``formId``: 폼 ID (단일 조회 시 포함, list 조회 시 미포함)

        - ``responseId``: 응답 ID

        - ``createTime``: 첫 제출 시각 (RFC3339)

        - ``lastSubmittedTime``: 최근 제출 시각

        - ``respondentEmail``: 응답자 이메일 (이메일 수집 설정 시)

        - ``answers``: 질문별 답변 (map)

        - ``totalScore``: 퀴즈 자동 채점 점수 (퀴즈 폼 + 채점 완료 시만)


        Native pass-through.'
      operationId: google_forms_get_response
      parameters:
      - name: formId
        in: path
        required: true
        schema:
          type: string
          title: Formid
      - name: responseId
        in: path
        required: true
        schema:
          type: string
          title: Responseid
      - 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)