Development — entry 030 of 100
Google Docs
The Google Docs API is a REST interface for creating and editing Google Docs documents programmatically — inserting and formatting text, tables, and images, and reading structured document content back out via `documents.get`. It requires OAuth 2.0 user consent (or domain-wide delegation for admin use cases) and operates on the same documents users see in the Docs UI, making it well suited to templated contract/report generation and bulk-editing workflows. Standard use is free under Google Cloud project quotas (currently 300 read / 60 write requests per minute per user).
GreatAPIs Score
Embed this badge
<a href="https://greatapis.com/api/google-docs/"><img src="https://greatapis.com/badge/google-docs.svg" alt="Scored 77 on greatapis.com"></a>Auth quickstart
- Register an app / run the OAuth flow to obtain a bearer token.
- Send it as an Authorization header
Authorization: Bearer <token>
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Endpoints
documents3
POST/v1/documents
application/json — Document
| Status | Description | Schema |
|---|---|---|
200 | Successful response | Document |
GET/v1/documents/{documentId}
| Name | In | Required | Type |
|---|---|---|---|
documentId | path | yes | string |
suggestionsViewMode | query | no | string |
| Status | Description | Schema |
|---|---|---|
200 | Successful response | Document |
POST/v1/documents/{documentId}:batchUpdate
| Name | In | Required | Type |
|---|---|---|---|
documentId | path | yes | string |
application/json — BatchUpdateDocumentRequest
| Status | Description | Schema |
|---|---|---|
200 | Successful response | BatchUpdateDocumentResponse |
Try it
Developer reference
https://docs.googleapis.comGoogle's Docs API usage-limits docs (developers.google.com/workspace/docs/api/limits) publish flat per-minute quotas: Read requests are capped at 3,000/minute/project and 300/minute/user/project, and Write requests at 600/minute/project and 60/minute/user/project. Exceeding a limit returns a 429 (Too many requests) HTTP status; Google recommends a truncated exponential backoff before retrying. Standard use remains free under these quotas, though Google's docs note overage past the published limits will incur billing starting in 2026.
- POST/v1/documents
- GET/v1/documents/{documentId}
- POST/v1/documents/{documentId}:batchUpdate