googleapis/google-api-go-client
Google Api Go Client
The Google API Go Client Library is a collection of auto-generated Go packages designed to facilitate authenticated requests to Google services via HTTP and gRPC. It serves as an API request and response manager that converts API discovery documents into typed code to provide a consistent interface for interacting with various services.
The library includes a dedicated OAuth 2.0 authentication client used to manage token lifecycles, handle service account credentials, and perform authorization flows. It supports identity impersonation, allowing a security context to assume the identity of a target service account for specific API calls.
Broad capability areas include API request optimization through response pagination and field filtering, as well as asynchronous operation tracking for monitoring long-running tasks. The project also provides a communication interface for configuring connection pools, overriding service endpoints, and injecting custom transport layers.
Features
- Google API Integrations - Provides auto-generated typed clients for calling Google API services with authentication and request signing.
- Custom API Endpoints - Allows overriding default API endpoints to connect to custom or self-hosted Google service instances.
- Application Default Credential Authentications - Uses Google Application Default Credentials or service account JSON key files to authorize API calls.
- Credentials Object Authentications - Passes a pre-built credentials object to authenticate all API requests.
- Service Account Authenticators - Loads a service account or refresh token JSON file to authenticate API calls.
- API Key Authentications - Passes a simple API key string as the credential for JSON-over-HTTP API calls.
- OAuth2 Client Management - Provides OAuth2 scope configuration to control access permissions for Google API requests.
- OAuth2 Token Source Suppliers - Supplies an OAuth2 token source to obtain access tokens for API requests.
- Long-Running Operation Polling - Waits for asynchronous operations to complete by checking status with configurable backoff intervals.
- Token-Based Pagination Clients - Walks through paginated result sets by repeating requests with next-page tokens from previous responses.
- Module Version Listers - Lists available versions of a Go module in descending order, including tagged releases and pseudo-versions.
- Symbol Search Interfaces - Searches Go packages and symbols by query string, returning results sorted by relevance.
- Exported Symbol Listers - Lists exported symbols from a Go package with filtering and pagination support.
- Client Certificate Authentication - Provides a callback to obtain a TLS client certificate for mutual TLS authentication.
- Account Impersonation - Impersonates a target service account using a chain of delegate accounts for authentication.
- Module Detail Retrievers - Retrieves structured information about a Go module, including versions, licenses, and README content.
- Package Detail Retrievers - Retrieves structured information about a Go package, including documentation, imports, and license details.
- Quota Project Selectors - Enables selection of the Google Cloud project used for quota tracking on API requests.
- Descriptive HTTP Error Responses - Extracts HTTP status codes and structured error reasons from API responses using typed error wrappers.
