• Stars
    star
    6,858
  • Rank 5,456 (Top 0.2 %)
  • Language
    Python
  • License
    Apache License 2.0
  • Created over 10 years ago
  • Updated 8 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

🐍 The official Python client library for Google's discovery based APIs.

Google API Client

PyPI version

This is the Google API Python client library for Google's discovery based APIs. To get started, please see the docs folder.

This library is considered complete and is in maintenance mode. This means that we will address critical bugs and security issues but will not add any new features.

This library is officially supported by Google. However, the maintainers of this repository recommend using Cloud Client Libraries for Python, where possible, for new code development. For more information, please visit Client Libraries Explained.

Version 2.0 Release

The 2.0 release of google-api-python-client includes a substantial reliability improvement, compared with 1.x, as discovery documents are now cached in the library rather than fetched dynamically. It is highly recommended to upgrade from v1.x to v2.x.

Only python 3.7 and newer is supported. If you are not able to upgrade python, then please continue to use version 1.x as we will continue supporting python 2.7+ in v1.

Discovery documents will no longer be retrieved dynamically when you call discovery.build(). The discovery documents will instead be retrieved from the client library directly. New versions of this library are released weekly. As a result of caching the discovery documents, the size of this package is at least 50 MB larger compared to the previous version.

Please see the Migration Guide for more information.

Documentation

See the docs folder for more detailed instructions and additional documentation.

Other Google API libraries

The maintainers of this repository recommend using Cloud Client Libraries for Python, where possible, for new code development due to the following reasons:

With Cloud Client Libraries for Python:

  • There is a separate client library for each API, so you can choose which client libraries to download. Whereas, google-api-python-client is a single client library for all APIs. As a result, the total package size for google-api-python-client exceeds 50MB.
  • There are stricter controls for breaking changes to the underlying APIs as each client library is focused on a specific API.
  • There are more features in these Cloud Client Libraries as each library is focused on a specific API, and in some cases, the libraries are owned by team who specialized in that API.
  • Developers will benefit from intellisense.

For more information, please visit Client Libraries Explained.

Although there are many benefits to moving to Cloud Client Libraries for Python, the maintainers want to emphasize that google-api-python-client will continue to be supported.

For Google Ads API, we recommend using Google Ads API Client Library for Python.

For Google Firebase Admin API, we recommend using Firebase Admin Python SDK.

Installation

Install this library in a virtualenv using pip. virtualenv is a tool to create isolated Python environments. The basic problem it addresses is one of dependencies and versions, and indirectly permissions.

With virtualenv, it's possible to install this library without needing system install permissions, and without clashing with the installed system dependencies.

Mac/Linux

pip3 install virtualenv
virtualenv <your-env>
source <your-env>/bin/activate
<your-env>/bin/pip install google-api-python-client

Windows

pip install virtualenv
virtualenv <your-env>
<your-env>\Scripts\activate
<your-env>\Scripts\pip.exe install google-api-python-client

Supported Python Versions

Python 3.7, 3.8, 3.9, 3.10, 3.11 and 3.12 are fully supported and tested. This library may work on later versions of 3, but we do not currently run tests against those versions.

Unsupported Python Versions

Python < 3.7

Third Party Libraries and Dependencies

The following libraries will be installed when you install the client library:

For development you will also need the following libraries:

Contributing

Please see our Contribution Guide. In particular, we love pull requests - but please make sure to sign the contributor license agreement.

More Repositories

1

google-api-nodejs-client

Google's officially supported Node.js client library for accessing Google APIs. Support for authorization and authentication with OAuth 2.0, API Keys and JWT (Service Tokens) is included.
TypeScript
11,170
star
2

google-api-php-client

A PHP client library for accessing Google APIs
PHP
8,706
star
3

googleapis

Public interface definitions of Google APIs.
Starlark
6,434
star
4

google-cloud-python

Google Cloud Client Library for Python
Python
4,324
star
5

release-please

generate release PRs based on the conventionalcommits.org spec
TypeScript
4,099
star
6

google-api-go-client

Auto-generated Google APIs for Go.
Go
3,572
star
7

google-cloud-go

Google Cloud Client Libraries for Go.
Go
3,361
star
8

google-api-ruby-client

REST client for Google APIs
Ruby
2,679
star
9

google-cloud-node

Google Cloud Client Library for Node.js
TypeScript
2,654
star
10

google-cloud-java

Google Cloud Client Library for Java
Java
1,773
star
11

google-auth-library-nodejs

πŸ”‘ Google Auth Library for Node.js
TypeScript
1,549
star
12

google-http-java-client

Google HTTP Client Library for Java
Java
1,342
star
13

google-api-dotnet-client

Google APIs Client Library for .NET
C#
1,304
star
14

google-api-java-client

Google APIs Client Library for Java
Java
1,300
star
15

google-cloud-ruby

Google Cloud Client Library for Ruby
Ruby
1,293
star
16

google-auth-library-php

Google Auth Library for PHP
PHP
1,287
star
17

google-api-php-client-services

PHP
1,179
star
18

google-cloud-php

Google Cloud Client Library for PHP
PHP
1,060
star
19

google-cloud-dotnet

Google Cloud Client Libraries for .NET
C#
914
star
20

nodejs-storage

Node.js client for Google Cloud Storage: unified object storage for developers and enterprises, from live data serving to data analytics/ML to data archiving.
TypeScript
828
star
21

oauth2client

This is a Python library for accessing resources protected by OAuth 2.0.
Python
795
star
22

nodejs-dialogflow

Node.js client for Dialogflow: Design and integrate a conversational user interface into your applications and devices.
JavaScript
793
star
23

elixir-google-api

Elixir client libraries for accessing Google APIs.
Elixir
748
star
24

google-auth-library-python

Google Auth Python Library
Python
744
star
25

python-bigquery

Python
706
star
26

gaxios

An HTTP request client that provides an axios like interface over top of node-fetch. Super lightweight. Supports proxies and all sorts of other stuff.
TypeScript
692
star
27

nodejs-speech

This repository is deprecated. All of its content and history has been moved to googleapis/google-cloud-node.
684
star
28

nodejs-firestore

Node.js client for Google Cloud Firestore: a NoSQL document database built for automatic scaling, high performance, and ease of application development.
JavaScript
612
star
29

google-oauth-java-client

Google OAuth Client Library for Java
Java
601
star
30

go-genproto

Generated code for Google Cloud client libraries.
Go
558
star
31

repo-automation-bots

A collection of bots, based on probot, for performing common maintenance tasks across the open-source repos managed by Google on GitHub.
TypeScript
545
star
32

api-linter

A linter for APIs defined in protocol buffers.
Go
540
star
33

python-aiplatform

A Python SDK for Vertex AI, a fully managed, end-to-end platform for data science and machine learning.
Python
524
star
34

nodejs-translate

Node.js client for Google Cloud Translate: Dynamically translate text between thousands of language pairs.
JavaScript
514
star
35

google-cloud-cpp

C++ Client Libraries for Google Cloud Services
C++
508
star
36

nodejs-pubsub

Node.js client for Google Cloud Pub/Sub: Ingest event streams from anywhere, at any scale, for simple, reliable, real-time stream analytics.
TypeScript
498
star
37

nodejs-vision

Node.js client for Google Cloud Vision: Derive insight from images.
TypeScript
497
star
38

google-api-java-client-services

Generated Java code for Google APIs
497
star
39

nodejs-bigquery

Node.js client for Google Cloud BigQuery: A fast, economical and fully-managed enterprise data warehouse for large-scale data analytics.
TypeScript
420
star
40

python-bigquery-pandas

Google BigQuery connector for pandas
Python
418
star
41

google-auth-library-ruby

Google Auth Library for Ruby
Ruby
417
star
42

python-bigquery-sqlalchemy

SQLAlchemy dialect for BigQuery
Python
411
star
43

google-auth-library-java

Open source Auth client library for Java
Java
399
star
44

python-dialogflow

This library has moved to https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-dialogflow
397
star
45

python-pubsub

Python
368
star
46

signet

Signet is an OAuth 1.0 / OAuth 2.0 implementation.
Ruby
364
star
47

nodejs-text-to-speech

Node.js client for Google Cloud Text-to-Speech
JavaScript
355
star
48

python-speech

This library has moved to https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-speech
355
star
49

python-storage

Python
339
star
50

google-cloud-php-storage

PHP
317
star
51

google-cloud-php-core

PHP
309
star
52

gapic-generator

Tools for generating API client libraries from API Service Configuration descriptions.
Java
303
star
53

cloud-trace-nodejs

Node.js agent for Cloud Trace: automatically gather latency data about your application
TypeScript
272
star
54

gapic-generator-go

Generate Go API client libraries from Protocol Buffers.
Go
236
star
55

gax-php

Google API Extensions for PHP
PHP
226
star
56

api-common-protos

A standard library for use in specifying protocol buffer APIs.
Starlark
221
star
57

google-cloud-datastore

Low-level, Protobuf-based Java and Python client libraries for Cloud Datastore. Check out google-cloud-java and google-cloud-python first!
Python
212
star
58

python-firestore

Python
205
star
59

nodejs-datastore

Node.js client for Google Cloud Datastore: a highly-scalable NoSQL database for your web and mobile applications.
TypeScript
196
star
60

google-cloud-rust

Rust
183
star
61

google-cloud-php-translate

PHP
182
star
62

github-repo-automation

A set of tools to automate multiple GitHub repository management.
TypeScript
172
star
63

cloud-debug-nodejs

Node.js agent for Google Cloud Debugger: investigate your code’s behavior in production
TypeScript
169
star
64

google-cloud-php-firestore

PHP
168
star
65

gapic-showcase

An API that demonstrates Generated API Client (GAPIC) features and common API patterns used by Google.
Go
165
star
66

java-bigtable-hbase

Java libraries and HBase client extensions for accessing Google Cloud Bigtable
Java
165
star
67

gax-java

This library has moved to https://github.com/googleapis/sdk-platform-java/tree/main/gax-java.
162
star
68

python-vision

This library has moved to https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-vision
160
star
69

google-auth-library-python-oauthlib

Python
160
star
70

nodejs-logging

Node.js client for Stackdriver Logging: Store, search, analyze, monitor, and alert on log data and events from Google Cloud Platform and Amazon Web Services (AWS).
TypeScript
156
star
71

python-bigquery-dataframes

BigQuery DataFrames
Python
146
star
72

nodejs-tasks

Node.js client for Google Cloud Tasks: A fully managed service that allows you to manage the execution, dispatch and delivery of a large number of distributed tasks.
TypeScript
144
star
73

python-ndb

Python
144
star
74

common-protos-php

PHP protocol buffer classes generated from https://github.com/googleapis/api-common-protos
PHP
132
star
75

artman

Artifact Manager, a build and packaging tool for Google API client libraries.
Python
132
star
76

proto-plus-python

Beautiful, idiomatic protocol buffers in Python
Python
132
star
77

googleapis.github.io

The GitHub pages site for the googleapis organization.
HTML
131
star
78

nodejs-language

Node.js client for Google Cloud Natural Language: Derive insights from unstructured text using Google machine learning.
JavaScript
131
star
79

google-cloudevents

Types for CloudEvents issued by Google
JavaScript
130
star
80

python-analytics-data

Python
125
star
81

google-auth-library-swift

Auth client library for Swift command-line tools and cloud services. Supports OAuth1, OAuth2, and Google Application Default Credentials.
Swift
122
star
82

java-pubsub

Java
118
star
83

gapic-generator-python

Generate Python API client libraries from Protocol Buffers.
Python
115
star
84

nodejs-compute

Node.js client for Google Compute Engine: Scalable, High-Performance Virtual Machines
JavaScript
115
star
85

python-texttospeech

Python
111
star
86

nodejs-spanner

Node.js client for Google Cloud Spanner: the world’s first fully managed relational database service to offer both strong consistency and horizontal scalability.
TypeScript
111
star
87

python-translate

This library has moved to https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-translate
108
star
88

node-gtoken

πŸ”‘ Google Auth Service Account Tokens for Node.js
TypeScript
108
star
89

python-api-core

Python
107
star
90

java-bigquery

Java
105
star
91

google-cloud-php-vision

PHP
101
star
92

gax-nodejs

Google API Extensions for Node.js
TypeScript
100
star
93

nodejs-logging-winston

Node.js client integration between Stackdriver Logging and Winston.
TypeScript
100
star
94

python-logging

Python
99
star
95

go-sql-spanner

Google Cloud Spanner driver for Go's database/sql package.
Go
97
star
96

java-firestore

Java
96
star
97

java-storage

Java
95
star
98

nodejs-bigtable

Node.js client for Google Cloud Bigtable: Google's NoSQL Big Data database service.
TypeScript
91
star
99

nodejs-secret-manager

A cloud-hosted service that provides a secure and convenient tool for storing API keys, passwords, certificates, and other sensitive data.
JavaScript
89
star
100

nodejs-automl

Node.js client for Google Cloud AutoML: Train high quality custom machine learning models with minimum effort and machine learning expertise.
TypeScript
87
star