Google Cloud Node.js Client Libraries
Node.js idiomatic client libraries for Google Cloud Platform services.
Libraries are available on GitHub and npm for developing Node.js
applications that interact with individual Google Cloud services:, Repo, API Docs, Install Command, Enable, Free Tier, ------, ----------, -----------------, -----------, ------------, Asset Inventory, :notebook:, npm i @google-cloud/asset, enable, ✖, AutoML, :notebook:, npm i @google-cloud/automl, enable, ✖, BigQuery, :notebook:, npm i @google-cloud/bigquery, enable, ✔, Bigtable, :notebook:, npm i @google-cloud/bigtable, enable, ✖, Billing Budgets, :notebook:, npm i @google-cloud/billing-budgets, enable, ✖, Build, :notebook:, npm i @google-cloud/cloudbuild, enable, ✖, Data Catalog, :notebook:, npm i @google-cloud/datacatalog, enable, ✖, Data Labeling, :notebook:, npm i @google-cloud/datalabeling, enable, ✖, Data Loss Prevention, :notebook:, npm i @google-cloud/dlp, enable, ✖, Dataproc, :notebook:, npm i @google-cloud/dataproc, enable, ✖, Datastore, :notebook:, npm i @google-cloud/datastore, enable, ✔, Datastore Session, :notebook:, npm i @google-cloud/connect-datastore, enable, ✔, Dialogflow API, :notebook:, npm i dialogflow, enable, ✖, DNS, :notebook:, npm i @google-cloud/dns, enable, ✖, Firestore, :notebook:, npm i @google-cloud/firestore, enable, ✔, Firestore Session, :notebook:, npm i @google-cloud/firestore-session, enable, ✔, Google BigQuery Data Transfer Service, :notebook:, npm i @google-cloud/bigquery-data-transfer, enable, ✖, Google Compute Engine, :notebook:, npm i @google-cloud/compute, enable, ✖, Google Container Analysis, :notebook:, npm i @google-cloud/containeranalysis, enable, ✖, Grafeas, :notebook:, npm i @google-cloud/grafeas, enable, ✔, Internet of Things (IoT) Core, :notebook:, npm i @google-cloud/iot, enable, ✖, Key Management Service, :notebook:, npm i @google-cloud/kms, enable, ✖, Kubernetes Engine Cluster Manager API, :notebook:, npm i @google-cloud/container, enable, ✖, Monitoring Dashboards, :notebook:, npm i @google-cloud/monitoring-dashboards, enable, ✖, Natural Language, :notebook:, npm i @google-cloud/language, enable, ✖, OS Login, :notebook:, npm i @google-cloud/os-login, enable, ✖, Phishing Protection, :notebook:, npm i @google-cloud/phishing-protection, enable, ✖, Pub/Sub, :notebook:, npm i @google-cloud/pubsub, enable, ✖, reCAPTCHA Enterprise, :notebook:, npm i @google-cloud/recaptcha-enterprise, enable, ✖, Recommender, :notebook:, npm i @google-cloud/recommender, enable, ✖, Redis, :notebook:, npm i @google-cloud/redis, enable, ✖, Resource Manager API, :notebook:, npm i @google-cloud/resource, enable, ✖, Runtime Config, :notebook:, npm i @google-cloud/rcloadenv, enable, ✔, Scheduler, :notebook:, npm i @google-cloud/scheduler, enable, ✔, Secret Manager, :notebook:, npm i @google-cloud/secret-manager, enable, ✖, Security Command Center, :notebook:, npm i @google-cloud/security-center, enable, ✖, Spanner, :notebook:, npm i @google-cloud/spanner, enable, ✖, Speech, :notebook:, npm i @google-cloud/speech, enable, ✔, Stackdriver Debugger, :notebook:, npm i @google-cloud/debug-agent, enable, ✔, Stackdriver Error Reporting, :notebook:, npm i @google-cloud/error-reporting, enable, ✔, Stackdriver Incident Response & Management, :notebook:, npm i @google-cloud/irm, enable, ✖, Stackdriver Logging, :notebook:, npm i @google-cloud/logging, enable, ✔, Stackdriver Logging for Bunyan, :notebook:, npm i @google-cloud/logging-bunyan, enable, ✔, Stackdriver Logging for Winston, :notebook:, npm i @google-cloud/logging-winston, enable, ✔, Stackdriver Monitoring, :notebook:, npm i @google-cloud/monitoring, enable, ✖, Stackdriver Profiler, :notebook:, npm i @google-cloud/profiler, enable, ✔, Stackdriver Trace, :notebook:, npm i @google-cloud/trace-agent, enable, ✔, Storage, :notebook:, npm i @google-cloud/storage, enable, ✖, Talent Solution, :notebook:, npm i @google-cloud/talent, enable, ✖, Tasks, :notebook:, npm i @google-cloud/tasks, enable, ✖, Text-to-Speech, :notebook:, npm i @google-cloud/text-to-speech, enable, ✖, Translation, :notebook:, npm i @google-cloud/translate, enable, ✖, Video Intelligence, :notebook:, npm i @google-cloud/video-intelligence, enable, ✖, Vision API, :notebook:, npm i @google-cloud/vision, enable, ✖, Web Risk API, :notebook:, npm i @google-cloud/web-risk, enable, ✖, If the service is not listed above, google-api-nodejs-client interfaces
with additional Google Cloud APIs using a legacy REST interface.
When building Node.js applications, preference should be given to the libraries listed in the table.
Enabling APIs
Before you can interact with a given Google Cloud Service, you must enable its API.
Links are available for enabling APIs in the table at the beginning of this document, and in
each libraries README.md.
Authentication
Download your Service Account Credentials JSON file
To use Application Default Credentials, You first need to download a set of JSON credentials for your project. Go to APIs & Auth > Credentials in the Google Developers Console and select Service account from the Add credentials dropdown.
This file is your only copy of these credentials. It should never be
committed with your source code, and should be stored securely.
Once downloaded, store the path to this file in the GOOGLE_APPLICATION_CREDENTIALS environment variable.
Other Authentication Methods
Other authentication methods are outlined in the README for google-auth-library-nodejs,
which is the authentication library used by all Google Cloud Node.js clients.
Example Applications
- nodejs-getting-started - 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.
- gcloud-node-todos - A TodoMVC backend using google-cloud-node and Datastore.
- gitnpm - Easily lookup an npm package's GitHub repo using google-cloud-node and Google App Engine.
- gcloud-kvstore - Use Datastore as a simple key-value store.
- hya-wave - Cloud-based web sample editor. Part of the hya-io family of products.
- gstore-node - Google Datastore Entities Modeling library.
- gstore-api - REST API builder for Google Datastore Entities.
Versioning
Our libraries follow Semantic Versioning.
Please note it is currently under active development. Any release versioned 0.x.y is subject to backwards-incompatible changes at any time.
GA: Libraries defined at the GA (general availability) quality level are stable. The code surface will not change in backwards-incompatible ways unless 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.
Please note that the auto-generated portions of the GA libraries (the ones in modules such as v1 or v2) are considered to be of Beta quality, even if the libraries that wrap them are GA.
Beta: Libraries defined at the Beta quality level are expected to be mostly stable, while we work towards their release candidate. We will address issues and requests with a higher priority.
Alpha: Libraries defined at the Alpha quality level are still a work-in-progress and are more likely to get backwards-incompatible updates.
Contributing
Contributions to this library are always welcome and highly encouraged.
See CONTRIBUTING for more information on how to get started.
License
Apache 2.0 - See LICENSE for more information.
