bhanditz / google-cloud-python

Google Cloud Client Library for Python

Google Cloud Python Client

Python idiomatic clients for Google Cloud Platform services.

• Homepage
• API Documentation
• Read The Docs Documentation

Heads up! These libraries are supported on App Engine standard's Python 3 runtime but are not supported on App Engine's Python 2 runtime.

General Availability

GA (general availability) indicates that the client library for a particular service is stable, and that the code surface will not change in backwards-incompatible ways unless either absolutely necessary (e.g. because of critical security issues) or with an extensive deprecation period. Issues and requests against GA libraries are addressed with the highest priority.

Note

Sub-components of GA libraries explicitly marked as beta in the import path (e.g. google.cloud.language_v1beta2) should be considered to be beta.

The following client libraries have GA support:

• Google BigQuery (BigQuery README)
• Google Cloud Datastore (Datastore README)
• Google Cloud Natural Language (Natural Language README)
• Google Cloud Spanner (Spanner README)
• Google Cloud Storage (Storage README)
• Google Cloud Translation (Translation README)
• Stackdriver Logging (Logging README)

Beta Support

Beta indicates that the client library for a particular service is mostly stable and is being prepared for release. Issues and requests against beta libraries are addressed with a higher priority.

The following client libraries have beta support:

• Google Cloud Bigtable (Bigtable README)
• Google Cloud Firestore (Firestore README)
• Google Cloud Pub/Sub (Pub/Sub README)
• Google Cloud Speech (Speech README)
• Google Cloud Video Intelligence (Video Intelligence README)
• Google Cloud Vision (Vision README)

Alpha Support

Alpha indicates that the client library for a particular service is still a work-in-progress and is more likely to get backwards-incompatible updates. See versioning for more details.

The following client libraries have alpha support:

• Google Cloud Asset (Asset README)
• Google Cloud AutoML (AutoML README)
• Google BigQuery Data Transfer (BigQuery Data Transfer README)
• Google Cloud Bigtable - HappyBase (HappyBase README)
• Google Cloud Container (Container README)
• Google Cloud Dataproc (Dataproc README)
• Google Cloud DLP (DLP README)
• Google Cloud DNS (DNS README)
• Google Cloud IoT (IoT README)
• Google Cloud KMS (KMS README)
• Google Cloud Memorystore for Redis (Redis README)
• Google Cloud Resource Manager (Resource Manager README)
• Google Cloud Runtime Configuration (Runtime Config README)
• Google Cloud Security Scanner (Security Scanner README )
• Google Cloud Tasks (Tasks README)
• Google Cloud Trace (Trace README)
• Google Cloud Text-to-Speech (Text-to-Speech README)
• Stackdriver Error Reporting (Error Reporting README)
• Stackdriver Monitoring (Monitoring README)

If you need support for other Google APIs, check out the Google APIs Python Client library.

Example Applications

• getting-started-python - A sample and tutorial that demonstrates how to build a complete web application using Cloud Datastore, Cloud Storage, and Cloud Pub/Sub and deploy it to Google App Engine or Google Compute Engine.
• google-cloud-python-expenses-demo - A sample expenses demo using Cloud Datastore and Cloud Storage

Authentication

With google-cloud-python we try to make authentication as painless as possible. Check out the Authentication section in our documentation to learn more. You may also find the authentication document shared by all the google-cloud-* libraries to be helpful.

Contributing

Contributions to this library are always welcome and highly encouraged.

See the CONTRIBUTING doc for more information on how to get started.

Community

Google Cloud Platform Python developers hang out in Slack in the #python channel, click here to get an invitation.

License

Apache 2.0 - See the LICENSE for more information.