This repository provides idiomatic Node.js client libraries for interacting with a vast array of Google Cloud Platform services. It targets Node.js developers building applications on Google Cloud, offering a unified and consistent way to access GCP functionalities.

How It Works

The project offers individual client libraries for each Google Cloud service, promoting modularity and reducing the footprint of applications. For services not explicitly listed, a legacy REST interface via google-api-nodejs-client is available. The libraries leverage google-auth-library-nodejs for authentication, supporting Application Default Credentials via a service account JSON file.

Quick Start & Requirements

• Install: Individual libraries are installed via npm (e.g., npm install @google-cloud/storage).
• Prerequisites: Node.js (active or maintenance LTS versions recommended).
• Authentication: Requires Google Cloud API enablement and setting the GOOGLE_APPLICATION_CREDENTIALS environment variable to a service account JSON file.
• Resources: Links to example applications and contribution guidelines are provided.

Highlighted Details

• Comprehensive coverage of numerous Google Cloud services with dedicated client libraries.
• Follows Semantic Versioning, with a note that 0.x.y releases may have breaking changes.
• Supports active and maintenance Node.js LTS versions, with best-effort support for legacy versions.
• Provides example applications demonstrating integration with various GCP services.

Maintenance & Community

The project is actively maintained by Google. Contribution guidelines are available in the CONTRIBUTING file.

Licensing & Compatibility

• License: Apache 2.0.
• Compatibility: Compatible with commercial and closed-source applications.

Limitations & Caveats

Libraries under 0.x.y versioning are subject to backwards-incompatible changes. Legacy Node.js versions receive best-effort support, with potential issues regarding testing, security patches, and dependency updates.