google/google-api-go-client
Google Api Go Client
This project is a collection of Go packages and a programmatic interface for interacting with Google services and Google Cloud resources via REST APIs. It functions as a client library and SDK that transforms raw HTTP requests into structured Go function calls.
The library utilizes discovery-based client generation to create type-safe clients from API discovery documents. It separates the acquisition of authorization tokens from the request logic through a token-source based authentication model.
The project covers identity management and authentication via OAuth 2.0, service accounts, and API keys. Its architectural surface includes a middleware-based request pipeline, transport-layer abstractions for retries and timeouts, and interface-based service modeling for testing.
Features
- Google API Integrations - Provides the official Go client libraries for connecting applications to the ecosystem of Google web APIs.
- Google Cloud SDKs - Offers a typed Go interface for programmatically controlling and configuring Google Cloud infrastructure and services.
- Go Client Libraries - Supplies Go-specific client libraries for managing Google Cloud resources and services.
- Service Account Authenticators - Authorizes server-to-server requests using JSON key files, metadata services, and application default credentials.
- API Request Authentication - Manages the attachment of API keys and identity tokens to outgoing requests to ensure secure access to remote services.
- Credential Verifications - Verifies identity using default credentials, key files, or custom token sources to authorize remote service calls.
- OAuth 2.0 Client Implementations - Implements an OAuth 2.0 client library for managing user authorization, service accounts, and access tokens.
- API Client Generators - Automatically generates type-safe Go client libraries from API discovery documents describing endpoints and schemas.
- Struct Marshallers - Implements conversion of strongly typed Go structs into JSON payloads and parses response bodies back into native types.
- REST API Clients - Transforms raw HTTP requests into structured Go function calls with integrated error and response handling.
- Transport Abstractions - Wraps the standard HTTP client to provide a transport abstraction for custom timeout logic and automatic retries.
- Middleware-Based Request Pipelines - Processes outgoing HTTP requests through a modular chain of handlers for authentication injection and global error logging.
- API Key Authentication - Provides the capability to attach developer-specific API keys to outgoing requests for basic service identification.
- OAuth2 Implementations - Implements secure OAuth2 login flows to acquire authorization tokens for accessing private user data via Google APIs.
- Authorization Token Flows - Supports redirecting users through web flows to acquire authorization tokens for accessing private resource data.
- OAuth2 Token Source Suppliers - Decouples the acquisition of OAuth2 tokens from the request logic using a dedicated token-source supplier model.
- Service Mocking Interfaces - Represents remote API services as Go interfaces to facilitate mocking and testing of network dependencies.
- DevOps & Infrastructure - Client libraries for accessing Google APIs.
- Third Party APIs - Auto-generated clients for Google APIs.
- Third-party APIs - Google API client library.
