How googleapis/google-api-python-client works
Google API Python Client builds dynamic Python clients for Google’s discovery-based APIs. A developer supplies an API name/version and options to discovery.build(); the library obtains the discovery document, configures authentication and a request model, and returns callable service resources whose requests are executed over HTTP. HTTP support includes media transfer and batching, while channel support handles push notifications. The graph also includes discovery caching and the documented API-description utility. Source excerpts are partial; unsampled capability links are omitted or marked unverified.
Main entry points: discovery.py Discovery builder · http.py HTTP requests · __init__.py Legacy import alias · model.py Request models
Components 22
Client construction
- Discovery builder
googleapiclient/discovery.py - API service resources
googleapiclient/discovery.py - Authentication
googleapiclient/_auth.py - Cache selection
googleapiclient/discovery_cache/__init__.py - Cache interface
googleapiclient/discovery_cache/base.py - File cache
googleapiclient/discovery_cache/file_cache.py - App Engine cache
googleapiclient/discovery_cache/appengine_memcache.py
Requests and transport
- HTTP requests
googleapiclient/http.py - Media transfer
googleapiclient/http.py - Batch requests
googleapiclient/http.py - Push channels
googleapiclient/channel.py
Shared support
- Request models
googleapiclient/model.py - MIME parsing
googleapiclient/mimeparse.py - Schema helpers
googleapiclient/schema.py - Error types
googleapiclient/errors.py - Runtime helpers
googleapiclient/_helpers.py - Version metadata
googleapiclient/version.py
Related utilities
- Sample utilities
googleapiclient/sample_tools.py - API description
describe.py - Legacy import alias
apiclient/__init__.py
Other components
- Developer
- Google API
Connections 34
- Developer → Discovery builder: builds client
README.md - Discovery builder → Cache selection: loads documents
googleapiclient/discovery.py - Cache selection → File cache: selects cache
googleapiclient/discovery_cache/__init__.py - Cache selection → App Engine cache: selects cache
googleapiclient/discovery_cache/__init__.py - File cache → Cache interface: implements
googleapiclient/discovery_cache/file_cache.py - App Engine cache → Cache interface: implements
googleapiclient/discovery_cache/appengine_memcache.py - Cache selection → File cache: reads documents
googleapiclient/discovery_cache/__init__.py - Discovery builder → Authentication: configures credentials
googleapiclient/discovery.py - Discovery builder → Request models: selects model
googleapiclient/discovery.py - Discovery builder → MIME parsing: uses parsing
googleapiclient/discovery.py - Discovery builder → Schema helpers: uses schemas
googleapiclient/discovery.py - Discovery builder → API service resources: creates resources
googleapiclient/discovery.py - API service resources → HTTP requests: builds requests
googleapiclient/discovery.py - HTTP requests → Google API: sends requests
- HTTP requests → Authentication: applies credentials
googleapiclient/http.py - HTTP requests → Request models: serializes payloads
googleapiclient/http.py - HTTP requests → Error types: raises errors
googleapiclient/http.py - Media transfer → HTTP requests: uses transport
googleapiclient/http.py - Batch requests → HTTP requests: uses transport
googleapiclient/http.py - Push channels → Runtime helpers: uses helpers
googleapiclient/channel.py - Push channels → Error types: raises errors
googleapiclient/channel.py - Request models → Error types: raises errors
googleapiclient/model.py - Request models → Version metadata: uses metadata
googleapiclient/model.py - Schema helpers → Runtime helpers: uses helpers
googleapiclient/schema.py - Sample utilities → Discovery builder: builds services
googleapiclient/sample_tools.py - Sample utilities → HTTP requests: uses transport
googleapiclient/sample_tools.py - API description → Discovery builder: builds service
describe.py - API description → HTTP requests: fetches documents
describe.py - Legacy import alias → Discovery builder: aliases imports
apiclient/__init__.py - Legacy import alias → Push channels: aliases imports
apiclient/__init__.py - Legacy import alias → HTTP requests: aliases imports
apiclient/__init__.py - Legacy import alias → Request models: aliases imports
apiclient/__init__.py - Legacy import alias → Schema helpers: aliases imports
apiclient/__init__.py - Legacy import alias → MIME parsing: aliases imports
apiclient/__init__.py