GoogleKit¶
Unofficial Python SDK for the Google Drive API, Google Sheets API, Google Calendar API, Google Docs API, and Google Slides API.
Unofficial
GoogleKit is not affiliated with, endorsed by, or sponsored by Google. Google trademarks remain the property of their owners. Prefer the official product docs linked below when resolving API semantics.
Site: https://ssujitx.github.io/GoogleKit/ · PyPI: googlekit · Repo: SSujitX/GoogleKit
Official Google documentation¶
| Product | Official docs |
|---|---|
| Google Workspace APIs | developers.google.com/workspace |
| Drive API | Drive API guides · REST reference |
| Sheets API | Sheets API guides · REST reference |
| Calendar API | Calendar API guides · REST reference |
| Docs API | Docs API guides · REST reference |
| Slides API | Slides API guides · REST reference |
| OAuth 2.0 | OAuth 2.0 · Scopes |
| ADC | Application Default Credentials |
Why GoogleKit?¶
- One consistent Python API across five Google Workspace products
- Managers (full control) plus optional shortcuts (flat helpers) — both autocomplete after
client.drive. - Google client libraries included by default (
uv add googlekit/pip install googlekit) - OAuth 2.0 desktop, service accounts, Application Default Credentials (ADC), and dedicated
auto()discovery - Least-privilege scope presets per service
- Retries, lazy pagination, typed exceptions, and
py.typedsupport
Quick start¶
from googlekit import GoogleKit
from googlekit.auth.scopes import ScopeProfile
client = GoogleKit.auto(services=["gdrive", "gsheets"], profile=ScopeProfile.FULL)
# Managers
page = client.drive.files.list(folder_id="root")
client.sheets.values.write("sid", "Sheet1!A1", [["Ada", 98]])
# Optional shortcuts (equivalent)
page = client.drive.list_files(folder_id="root")
client.sheets.write_values("sid", "Sheet1!A1", [["Ada", 98]])
Each service page documents both styles: Drive · Sheets · Calendar · Docs · Slides.
Documentation map¶
Getting started¶
| Page | What it covers |
|---|---|
| Installation | pip / uv, Python versions |
| Authentication | Four methods: ADC, service account, OAuth, auto-detect; security |
| Scopes | Scope presets, aggregation, InsufficientScopesError |
| Errors | Exception hierarchy and HTTP mapping |
Google Workspace services (full reference)¶
| Service | Page | Contents |
|---|---|---|
| Google Drive | Drive | Managers + shortcuts, files, folders, permissions, Shared Drives |
| Google Sheets | Sheets | Managers + shortcuts, values, worksheets, formatting |
| Google Calendar | Calendar | Managers + shortcuts, events, Meet, free/busy |
| Google Docs | Docs | Managers + shortcuts, text, tables, UTF-16 indexes |
| Google Slides | Slides | Managers + shortcuts, pages, shapes, images, tables |
Install¶
Then enable the APIs you need in Google Cloud Console → APIs & Services → Library.