google

google-api-python-client: Call Google's Discovery-Based APIs

The official Python client library for Google's discovery-based APIs, built around Google's API discovery documents. It generates service clients from bundled discovery data and remains actively maintained, though the maintainers recommend Cloud Client Libraries for new code where available.

ActivePythonApache-2.0LibraryAPIGoogle APIS
Stars
9k
Forks
2.6k
Stars, last 30 days
+27
Last commit
2 days ago
Contributors
100+

Our take

Activeregular commits and releases

Health score

70/100

How it is scored
Activity
63
Community
89
Issues
57
Pull requests
70

+27 stars in the last 30 days

  • More contributors than 78% of the projects we track

This is an actively maintained, broad-coverage client for existing discovery-based integrations, but its maintenance-only status makes it a less compelling default for new projects than a suitable Cloud Client Library.

Good fit if

  • Your application needs a Google discovery-based API and this client supports it.
  • You maintain an existing integration and value continued critical-bug and security support.
  • Apache-2.0 licensing suits your project, and you accept the package's broad, shared API coverage.

Look elsewhere if

  • You are starting new code and a Cloud Client Library for your API is available.
  • You need new features from this project, which is in maintenance mode.
  • A package size over 50 MB is unsuitable for your deployment.
All health signals
Last commit2026-10-27 (2 days ago)
Commits, last 90 days28
Releases, last 12 months16 (latest v2.201.0, 2026-09-30)
Contributors100+ (top contributor: 29% of commits)
Issues closed, last 90 days17 (typically closed in 12 days)
Pull requests merged, last 90 days28 (typically merged in 0 days)
Project age12 years

Checked on 2026-10-30 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

8,975

Forks

2,596

Change since Nov 17, 2026: 0 stars·0 forks

Overview

google-api-python-client is Google's official Python client library for Google's discovery-based APIs. It uses API discovery documents bundled with the library to build clients, so applications can call supported Google APIs without fetching those documents dynamically at runtime.

It is a general-purpose client for Python developers who need access to discovery-based Google APIs. The project is in maintenance mode: it remains supported for critical bugs and security issues, while the maintainers recommend Google's Cloud Client Libraries for Python for new development where possible.

Key Features

  • Builds service clients for Google's discovery-based APIs with discovery.build().
  • Uses discovery documents packaged with the library rather than retrieving them dynamically at runtime.
  • Provides one client library covering many APIs, rather than a separate package for each API.
  • Supports Python 3.10 and newer.
  • Installs with pip and uses httplib2 and uritemplate as dependencies.

Use Cases

  • Python applications that need to call a Google API available through an API discovery document.
  • Existing projects already using this client that need ongoing fixes and security support without a feature-driven migration.
  • Teams maintaining integrations across multiple discovery-based APIs that prefer a single shared client package.
  • Developers working with Google APIs for which a more specialized Cloud Client Library is unavailable or unsuitable.

What you need

Detected in the repository

  • Python (from setup.py)
  • A test suite and automated checks on GitHub Actions

License in plain words

Apache-2.0permissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the license, the NOTICE file and a note of your changes
  • Share your changes: no
  • Includes an explicit patent grant from the contributors:

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install the package:

pip install google-api-python-client

See the documentation and README for setup and usage details.

Alternatives

  • cli: A command-line interface for Google Workspace APIs rather than a Python library for integrating discovery-based APIs into applications.
ProjectLanguageLicenseStarsStatus
google-api-python-clientPythonApache-2.09kActive
cliRustApache-2.031.8kQuiet

Considerations

  • The project explicitly does not plan to add features; maintenance focuses on critical bugs and security issues.
  • Python versions below 3.10 are unsupported by the current release line. The README directs users who cannot upgrade to the v1 branch.
  • Bundled discovery documents make the package at least 50 MB larger than the previous version, an important trade-off for deployments with size constraints.
  • The maintainers recommend Cloud Client Libraries where possible, citing API-specific packages, tighter control of breaking changes, more features in some cases, and improved IDE intellisense.
  • The repository is active, with regular commits and releases, and its contributor base is not concentrated around one person. Recent issue handling and merged pull requests also indicate ongoing maintenance.

Found this useful?

Share it with someone who would like google-api-python-client.

Comparisons