# googleapis/google-api-go-client architecture

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

- Interactive diagram: https://gitdiagram.com/googleapis/google-api-go-client
- Repository: https://github.com/googleapis/google-api-go-client

## Overview

This repository is a Go client library for calling Google APIs, alongside a generator; the runtime product is the generated clients and their shared support. A caller creates a service, selects a resource operation, and executes its request against a Google API. The graph groups the many generated API packages by domain and shows the shared request and authorization layers. README and sampled generated-client excerpts support this flow; unsampled clients are represented by their existing subsystem directories, not individually inspected.

Main entry points: [`internal/gensupport/send.go`](https://github.com/googleapis/google-api-go-client/blob/main/internal/gensupport/send.go) (Request Support), [`appengine`](https://github.com/googleapis/google-api-go-client/tree/main/appengine) (App Engine), [`storage/v1beta2/storage-gen.go`](https://github.com/googleapis/google-api-go-client/blob/main/storage/v1beta2/storage-gen.go) (Cloud Storage), [`option/option.go`](https://github.com/googleapis/google-api-go-client/blob/main/option/option.go) (Client Options)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Generated API Clients"]
  node_appengine["App Engine"]
  node_access["Access Management"]
  node_audit["Audit Manager"]
  node_recommendations["Recommendations"]
  node_generated["Other Generated APIs"]
end

subgraph group_cloud["Cloud Operations"]
  node_bigquery["BigQuery Services"]
  node_resource["Resource Management"]
  node_deployment["Deployment Manager"]
  node_storage["Cloud Storage<br/>[storage-gen.go]"]
  node_transfer["Storage Transfer"]
  node_batch["Storage Batch"]
  node_pipelines["Data Pipelines"]
  node_blockchain["Blockchain Nodes"]
  node_firebasestorage["Firebase Storage"]
end

subgraph group_support["Shared Runtime"]
  node_gensupport["Request Support<br/>[send.go]"]
  node_options["Client Options<br/>[option.go]"]
  node_googleapi["Google API Helpers<br/>[googleapi.go]"]
end

node_caller(("Go Application"))
node_api{{"Google API Services"}}

node_caller -->|"creates service"| node_appengine
node_caller -->|"creates service"| node_storage
node_caller -->|"selects API"| node_generated
node_appengine -->|"uses request support"| node_gensupport
node_storage -->|"uses request support"| node_gensupport
node_transfer -->|"uses request support"| node_gensupport
node_batch -->|"uses request support"| node_gensupport
node_pipelines -->|"uses request support"| node_gensupport
node_recommendations -->|"uses request support"| node_gensupport
node_blockchain -->|"uses request support"| node_gensupport
node_firebasestorage -->|"uses request support"| node_gensupport
node_appengine -->|"sends API requests"| node_api
node_storage -->|"sends API requests"| node_api
node_generated -->|"sends API requests"| node_api
node_options -->|"configures authorization"| node_appengine
node_options -->|"configures authorization"| node_storage
node_gensupport -.->|"uses helpers"| node_googleapi

click node_appengine "https://github.com/googleapis/google-api-go-client/tree/main/appengine"
click node_access "https://github.com/googleapis/google-api-go-client/tree/main/accesscontextmanager"
click node_audit "https://github.com/googleapis/google-api-go-client/blob/main/auditmanager/v1/auditmanager-gen.go"
click node_bigquery "https://github.com/googleapis/google-api-go-client/tree/main/bigqueryconnection"
click node_resource "https://github.com/googleapis/google-api-go-client/tree/main/cloudresourcemanager"
click node_deployment "https://github.com/googleapis/google-api-go-client/tree/main/deploymentmanager"
click node_storage "https://github.com/googleapis/google-api-go-client/blob/main/storage/v1beta2/storage-gen.go"
click node_transfer "https://github.com/googleapis/google-api-go-client/blob/main/storagetransfer/v1/storagetransfer-gen.go"
click node_batch "https://github.com/googleapis/google-api-go-client/blob/main/storagebatchoperations/v1/storagebatchoperations-gen.go"
click node_pipelines "https://github.com/googleapis/google-api-go-client/blob/main/datapipelines/v1/datapipelines-gen.go"
click node_recommendations "https://github.com/googleapis/google-api-go-client/blob/main/recommendationengine/v1beta1/recommendationengine-gen.go"
click node_blockchain "https://github.com/googleapis/google-api-go-client/blob/main/blockchainnodeengine/v1/blockchainnodeengine-gen.go"
click node_firebasestorage "https://github.com/googleapis/google-api-go-client/blob/main/firebasestorage/v1beta/firebasestorage-gen.go"
click node_gensupport "https://github.com/googleapis/google-api-go-client/blob/main/internal/gensupport/send.go"
click node_options "https://github.com/googleapis/google-api-go-client/blob/main/option/option.go"
click node_googleapi "https://github.com/googleapis/google-api-go-client/blob/main/googleapi/googleapi.go"

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_appengine,node_access,node_audit,node_recommendations,node_generated toneBlue
class node_bigquery,node_resource,node_deployment,node_storage,node_transfer,node_batch,node_pipelines,node_blockchain,node_firebasestorage toneAmber
class node_gensupport,node_options,node_googleapi,node_api toneMint
class node_caller toneIndigo
```

## Components

### Generated API Clients

- [App Engine](https://github.com/googleapis/google-api-go-client/tree/main/appengine): `appengine`
- [Access Management](https://github.com/googleapis/google-api-go-client/tree/main/accesscontextmanager): `accesscontextmanager`
- [Audit Manager](https://github.com/googleapis/google-api-go-client/blob/main/auditmanager/v1/auditmanager-gen.go): `auditmanager/v1/auditmanager-gen.go`
- [Recommendations](https://github.com/googleapis/google-api-go-client/blob/main/recommendationengine/v1beta1/recommendationengine-gen.go): `recommendationengine/v1beta1/recommendationengine-gen.go`
- **Other Generated APIs**

### Cloud Operations

- [BigQuery Services](https://github.com/googleapis/google-api-go-client/tree/main/bigqueryconnection): `bigqueryconnection`
- [Resource Management](https://github.com/googleapis/google-api-go-client/tree/main/cloudresourcemanager): `cloudresourcemanager`
- [Deployment Manager](https://github.com/googleapis/google-api-go-client/tree/main/deploymentmanager): `deploymentmanager`
- [Cloud Storage](https://github.com/googleapis/google-api-go-client/blob/main/storage/v1beta2/storage-gen.go): `storage/v1beta2/storage-gen.go`
- [Storage Transfer](https://github.com/googleapis/google-api-go-client/blob/main/storagetransfer/v1/storagetransfer-gen.go): `storagetransfer/v1/storagetransfer-gen.go`
- [Storage Batch](https://github.com/googleapis/google-api-go-client/blob/main/storagebatchoperations/v1/storagebatchoperations-gen.go): `storagebatchoperations/v1/storagebatchoperations-gen.go`
- [Data Pipelines](https://github.com/googleapis/google-api-go-client/blob/main/datapipelines/v1/datapipelines-gen.go): `datapipelines/v1/datapipelines-gen.go`
- [Blockchain Nodes](https://github.com/googleapis/google-api-go-client/blob/main/blockchainnodeengine/v1/blockchainnodeengine-gen.go): `blockchainnodeengine/v1/blockchainnodeengine-gen.go`
- [Firebase Storage](https://github.com/googleapis/google-api-go-client/blob/main/firebasestorage/v1beta/firebasestorage-gen.go): `firebasestorage/v1beta/firebasestorage-gen.go`

### Shared Runtime

- [Request Support](https://github.com/googleapis/google-api-go-client/blob/main/internal/gensupport/send.go): `internal/gensupport/send.go`
- [Client Options](https://github.com/googleapis/google-api-go-client/blob/main/option/option.go): `option/option.go`
- [Google API Helpers](https://github.com/googleapis/google-api-go-client/blob/main/googleapi/googleapi.go): `googleapi/googleapi.go`

### Other components

- **Go Application**
- **Google API Services**

## Connections

- Go Application → App Engine: creates service
- Go Application → Cloud Storage: creates service
- Go Application → Other Generated APIs: selects API
- App Engine → Request Support: uses request support (evidence: `appengine/v1/appengine-gen.go`)
- Cloud Storage → Request Support: uses request support (evidence: `storage/v1beta2/storage-gen.go`)
- Storage Transfer → Request Support: uses request support (evidence: `storagetransfer/v1/storagetransfer-gen.go`)
- Storage Batch → Request Support: uses request support (evidence: `storagebatchoperations/v1/storagebatchoperations-gen.go`)
- Data Pipelines → Request Support: uses request support (evidence: `datapipelines/v1/datapipelines-gen.go`)
- Recommendations → Request Support: uses request support (evidence: `recommendationengine/v1beta1/recommendationengine-gen.go`)
- Blockchain Nodes → Request Support: uses request support (evidence: `blockchainnodeengine/v1/blockchainnodeengine-gen.go`)
- Firebase Storage → Request Support: uses request support (evidence: `firebasestorage/v1beta/firebasestorage-gen.go`)
- App Engine → Google API Services: sends API requests
- Cloud Storage → Google API Services: sends API requests
- Other Generated APIs → Google API Services: sends API requests
- Client Options → App Engine: configures authorization
- Client Options → Cloud Storage: configures authorization
- Request Support → Google API Helpers: uses helpers
