# googleapis/google-cloud-python architecture

> Architecture diagram of the GitHub repository googleapis/google-cloud-python, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/googleapis/google-cloud-python
- Repository: https://github.com/googleapis/google-cloud-python

## Overview

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`](https://github.com/googleapis/google-cloud-python/tree/main/packages) (Cloud clients), [`packages/gapic-generator/gapic/cli/generate.py`](https://github.com/googleapis/google-cloud-python/blob/main/packages/gapic-generator/gapic/cli/generate.py) (Generator CLI), [`packages/gapic-generator/gapic/generator/generator.py`](https://github.com/googleapis/google-cloud-python/blob/main/packages/gapic-generator/gapic/generator/generator.py) (Code generator), [`packages/google-cloud-firestore/google/cloud/firestore_v1/base_pipeline.py`](https://github.com/googleapis/google-cloud-python/blob/main/packages/google-cloud-firestore/google/cloud/firestore_v1/base_pipeline.py) (Firestore pipelines)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Cloud API clients"]
  node_api_clients["Cloud clients"]
  node_admanager["Ad Manager API<br/>[client.py]"]
  node_appengine_api["App Engine API<br/>[appengine.py]"]
  node_discovery_api["Discovery Engine API"]
  node_bigquery_storage["BigQuery Storage API<br/>[storage.py]"]
  node_datamanager["Data Manager API"]
end

subgraph group_generation["Client generation"]
  node_generator_cli["Generator CLI<br/>[generate.py]"]
  node_generator_core["Code generator<br/>[generator.py]"]
  node_schema["API schema<br/>[api.py]"]
  node_samplegen["Sample generator<br/>[samplegen.py]"]
end

subgraph group_data["Data libraries"]
  node_firestore_pipeline["Firestore pipelines<br/>[base_pipeline.py]"]
  node_firestore_expr["Pipeline expressions"]
  node_db_dtypes["Database types<br/>[core.py]"]
end

subgraph group_integrations["Runtime integrations"]
  node_bigquery_magics["BigQuery magics<br/>[core.py]"]
  node_django_spanner["Django Spanner<br/>[base.py]"]
  node_auth["App Engine auth<br/>[app_engine.py]"]
  node_logging["App Engine logging<br/>[app_engine.py]"]
end

node_user(("Python developer"))
node_cloud_service{{"Google Cloud services"}}

node_user -->|"uses"| node_api_clients
node_api_clients -.->|"calls APIs"| node_cloud_service
node_api_clients -.->|"includes"| node_admanager
node_api_clients -.->|"includes"| node_appengine_api
node_api_clients -.->|"includes"| node_discovery_api
node_api_clients -.->|"includes"| node_bigquery_storage
node_api_clients -.->|"includes"| node_datamanager
node_generator_cli -.->|"invokes"| node_generator_core
node_generator_core -.->|"uses"| node_schema
node_generator_cli -.->|"generates samples"| node_samplegen
node_user -->|"builds queries"| node_firestore_pipeline
node_firestore_pipeline -->|"uses expressions"| node_firestore_expr
node_user -.->|"uses types"| node_db_dtypes
node_user -.->|"runs notebook magics"| node_bigquery_magics
node_user -.->|"uses adapter"| node_django_spanner
node_auth -.->|"provides credentials"| node_cloud_service
node_logging -.->|"sends logs"| node_cloud_service

click node_api_clients "https://github.com/googleapis/google-cloud-python/tree/main/packages"
click node_admanager "https://github.com/googleapis/google-cloud-python/blob/main/packages/google-ads-admanager/google/ads/admanager_v1/services/ad_review_center_ad_service/client.py"
click node_appengine_api "https://github.com/googleapis/google-cloud-python/blob/main/packages/google-cloud-appengine-admin/google/cloud/appengine_admin_v1/types/appengine.py"
click node_discovery_api "https://github.com/googleapis/google-cloud-python/blob/main/packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/types/site_search_engine_service.py"
click node_bigquery_storage "https://github.com/googleapis/google-cloud-python/blob/main/packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/types/storage.py"
click node_datamanager "https://github.com/googleapis/google-cloud-python/blob/main/packages/google-ads-datamanager/google/ads/datamanager_v1/types/ingestion_service.py"
click node_generator_cli "https://github.com/googleapis/google-cloud-python/blob/main/packages/gapic-generator/gapic/cli/generate.py"
click node_generator_core "https://github.com/googleapis/google-cloud-python/blob/main/packages/gapic-generator/gapic/generator/generator.py"
click node_schema "https://github.com/googleapis/google-cloud-python/blob/main/packages/gapic-generator/gapic/schema/api.py"
click node_samplegen "https://github.com/googleapis/google-cloud-python/blob/main/packages/gapic-generator/gapic/samplegen/samplegen.py"
click node_firestore_pipeline "https://github.com/googleapis/google-cloud-python/blob/main/packages/google-cloud-firestore/google/cloud/firestore_v1/base_pipeline.py"
click node_firestore_expr "https://github.com/googleapis/google-cloud-python/blob/main/packages/google-cloud-firestore/google/cloud/firestore_v1/pipeline_expressions.py"
click node_db_dtypes "https://github.com/googleapis/google-cloud-python/blob/main/packages/db-dtypes/db_dtypes/core.py"
click node_bigquery_magics "https://github.com/googleapis/google-cloud-python/blob/main/packages/bigquery-magics/bigquery_magics/core.py"
click node_django_spanner "https://github.com/googleapis/google-cloud-python/blob/main/packages/django-google-spanner/django_spanner/base.py"
click node_auth "https://github.com/googleapis/google-cloud-python/blob/main/packages/google-auth/google/auth/app_engine.py"
click node_logging "https://github.com/googleapis/google-cloud-python/blob/main/packages/google-cloud-logging/google/cloud/logging_v2/handlers/app_engine.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_api_clients,node_admanager,node_appengine_api,node_discovery_api,node_bigquery_storage,node_datamanager toneBlue
class node_generator_cli,node_generator_core,node_schema,node_samplegen toneAmber
class node_firestore_pipeline,node_firestore_expr,node_db_dtypes toneMint
class node_bigquery_magics,node_django_spanner,node_auth,node_logging toneRose
class node_user,node_cloud_service toneIndigo
```

## Components

### Cloud API clients

- [Cloud clients](https://github.com/googleapis/google-cloud-python/tree/main/packages): `packages`
- [Ad Manager API](https://github.com/googleapis/google-cloud-python/blob/main/packages/google-ads-admanager/google/ads/admanager_v1/services/ad_review_center_ad_service/client.py): `packages/google-ads-admanager/google/ads/admanager_v1/services/ad_review_center_ad_service/client.py`
- [App Engine API](https://github.com/googleapis/google-cloud-python/blob/main/packages/google-cloud-appengine-admin/google/cloud/appengine_admin_v1/types/appengine.py): `packages/google-cloud-appengine-admin/google/cloud/appengine_admin_v1/types/appengine.py`
- [Discovery Engine API](https://github.com/googleapis/google-cloud-python/blob/main/packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/types/site_search_engine_service.py): `packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/types/site_search_engine_service.py`
- [BigQuery Storage API](https://github.com/googleapis/google-cloud-python/blob/main/packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/types/storage.py): `packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/types/storage.py`
- [Data Manager API](https://github.com/googleapis/google-cloud-python/blob/main/packages/google-ads-datamanager/google/ads/datamanager_v1/types/ingestion_service.py): `packages/google-ads-datamanager/google/ads/datamanager_v1/types/ingestion_service.py`

### Client generation

- [Generator CLI](https://github.com/googleapis/google-cloud-python/blob/main/packages/gapic-generator/gapic/cli/generate.py): `packages/gapic-generator/gapic/cli/generate.py`
- [Code generator](https://github.com/googleapis/google-cloud-python/blob/main/packages/gapic-generator/gapic/generator/generator.py): `packages/gapic-generator/gapic/generator/generator.py`
- [API schema](https://github.com/googleapis/google-cloud-python/blob/main/packages/gapic-generator/gapic/schema/api.py): `packages/gapic-generator/gapic/schema/api.py`
- [Sample generator](https://github.com/googleapis/google-cloud-python/blob/main/packages/gapic-generator/gapic/samplegen/samplegen.py): `packages/gapic-generator/gapic/samplegen/samplegen.py`

### Data libraries

- [Firestore pipelines](https://github.com/googleapis/google-cloud-python/blob/main/packages/google-cloud-firestore/google/cloud/firestore_v1/base_pipeline.py): `packages/google-cloud-firestore/google/cloud/firestore_v1/base_pipeline.py`
- [Pipeline expressions](https://github.com/googleapis/google-cloud-python/blob/main/packages/google-cloud-firestore/google/cloud/firestore_v1/pipeline_expressions.py): `packages/google-cloud-firestore/google/cloud/firestore_v1/pipeline_expressions.py`
- [Database types](https://github.com/googleapis/google-cloud-python/blob/main/packages/db-dtypes/db_dtypes/core.py): `packages/db-dtypes/db_dtypes/core.py`

### Runtime integrations

- [BigQuery magics](https://github.com/googleapis/google-cloud-python/blob/main/packages/bigquery-magics/bigquery_magics/core.py): `packages/bigquery-magics/bigquery_magics/core.py`
- [Django Spanner](https://github.com/googleapis/google-cloud-python/blob/main/packages/django-google-spanner/django_spanner/base.py): `packages/django-google-spanner/django_spanner/base.py`
- [App Engine auth](https://github.com/googleapis/google-cloud-python/blob/main/packages/google-auth/google/auth/app_engine.py): `packages/google-auth/google/auth/app_engine.py`
- [App Engine logging](https://github.com/googleapis/google-cloud-python/blob/main/packages/google-cloud-logging/google/cloud/logging_v2/handlers/app_engine.py): `packages/google-cloud-logging/google/cloud/logging_v2/handlers/app_engine.py`

### Other components

- **Python developer**
- **Google Cloud services**

## Connections

- Python developer → Cloud clients: uses
- Cloud clients → Google Cloud services: calls APIs
- Cloud clients → Ad Manager API: includes
- Cloud clients → App Engine API: includes (evidence: `packages/google-cloud-appengine-admin/google/cloud/appengine_admin_v1/types/appengine.py`)
- Cloud clients → Discovery Engine API: includes (evidence: `packages/google-cloud-discoveryengine/google/cloud/discoveryengine_v1/types/site_search_engine_service.py`)
- Cloud clients → BigQuery Storage API: includes (evidence: `packages/google-cloud-bigquery-storage/google/cloud/bigquery_storage_v1/types/storage.py`)
- Cloud clients → Data Manager API: includes (evidence: `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 (evidence: `packages/google-cloud-firestore/google/cloud/firestore_v1/base_pipeline.py`)
- Firestore pipelines → Pipeline expressions: uses expressions (evidence: `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
