How googleapis/google-cloud-python works
This repository is a monorepo of idiomatic Google Cloud Python clients and related libraries. A typical user constructs a service client, sends requests to a Google API, and receives typed responses; the sampled sources mostly show message definitions rather than runtime client-call paths, so those links are documented at the product level. The tree also shows a GAPIC generator, Firestore pipeline expressions, BigQuery notebook magics, database adapters, and data-type helpers. The README excerpt and source samples do not establish detailed wiring for every package.
Main entry points: packages Cloud clients · generate.py Generator CLI · generator.py Code generator · base_pipeline.py Firestore pipelines
Components 19
Cloud API clients
- Cloud clients
packages - Ad Manager API
packages/google-ads-admanager/google/ads/admanager_v1/services/ad_review_center_ad_service/client.py - App Engine API
packages/google-cloud-appengine-admin/google/cloud/appengine_admin_v1/types/appengine.py - Discovery Engine API
packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/types/site_search_engine_service.py - BigQuery Storage API
packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/types/storage.py - Data Manager API
packages/google-ads-datamanager/google/ads/datamanager_v1/types/ingestion_service.py
Client generation
- Generator CLI
packages/gapic-generator/gapic/cli/generate.py - Code generator
packages/gapic-generator/gapic/generator/generator.py - API schema
packages/gapic-generator/gapic/schema/api.py - Sample generator
packages/gapic-generator/gapic/samplegen/samplegen.py
Data libraries
- Firestore pipelines
packages/google-cloud-firestore/google/cloud/firestore_v1/base_pipeline.py - Pipeline expressions
packages/google-cloud-firestore/google/cloud/firestore_v1/pipeline_expressions.py - Database types
packages/db-dtypes/db_dtypes/core.py
Runtime integrations
- BigQuery magics
packages/bigquery-magics/bigquery_magics/core.py - Django Spanner
packages/django-google-spanner/django_spanner/base.py - App Engine auth
packages/google-auth/google/auth/app_engine.py - App Engine logging
packages/google-cloud-logging/google/cloud/logging_v2/handlers/app_engine.py
Other components
- Python developer
- Google Cloud services
Connections 17
- Python developer → Cloud clients: uses
- Cloud clients → Google Cloud services: calls APIs
- Cloud clients → Ad Manager API: includes
- Cloud clients → App Engine API: includes
packages/google-cloud-appengine-admin/google/cloud/appengine_admin_v1/types/appengine.py - Cloud clients → Discovery Engine API: includes
packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/types/site_search_engine_service.py - Cloud clients → BigQuery Storage API: includes
packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/types/storage.py - Cloud clients → Data Manager API: includes
packages/google-ads-datamanager/google/ads/datamanager_v1/types/ingestion_service.py - Generator CLI → Code generator: invokes
- Code generator → API schema: uses
- Generator CLI → Sample generator: generates samples
- Python developer → Firestore pipelines: builds queries
packages/google-cloud-firestore/google/cloud/firestore_v1/base_pipeline.py - Firestore pipelines → Pipeline expressions: uses expressions
packages/google-cloud-firestore/google/cloud/firestore_v1/pipeline_expressions.py - Python developer → Database types: uses types
- Python developer → BigQuery magics: runs notebook magics
- Python developer → Django Spanner: uses adapter
- App Engine auth → Google Cloud services: provides credentials
- App Engine logging → Google Cloud services: sends logs