Google Cloud

Google Cloud Client Library for Ruby - an idiomatic, intuitive, and natural way for Ruby developers to integrate with Google Cloud Platform services, like Cloud Datastore and Cloud Storage.

One-line install

$ gem install google-cloud

What is it?

The google-cloud library is a client for accessing Google Cloud Platform services that significantly reduces the boilerplate code you have to write. The library provides high-level API abstractions so they're easier to understand. It embraces Ruby idioms, works well with the standard library, and integrates better with your codebase. All this means you spend more time creating code that matters to you.

The google-cloud library is configured to access Google Cloud Platform services and authenticate (OAuth 2.0) automatically on your behalf. With a one-line install and a private key, you are up and ready to go. Better yet, if you are running on a Google Compute Engine instance, the one-line install is enough!

Retrieve and entity from Cloud Datastore

require "google/cloud"

gcloud = Google::Cloud.new(
  "my-todo-project-id",
  "/path/to/keyfile.json"
)

datastore = gcloud.datastore

product = datastore.find "Product", 123

FAQ

What is the relationship between the gcloud package and the gcloud command-line tool?

Both the gcloud command-line tool and gcloud package are a part of the Google Cloud SDK: a collection of tools and libraries that enable you to easily create and manage resources on the Google Cloud Platform. The gcloud command-line tool can be used to manage both your development workflow and your Google Cloud Platform resources while the gcloud package is the Google Cloud Client Library for Ruby.

What is the relationship between gcloud and the Google APIs Ruby Client?

The Google APIs Ruby Client is a client library for using the broad set of Google APIs. gcloud is built specifically for the Google Cloud Platform and is the recommended way to integrate Google Cloud APIs into your Ruby applications. If your application requires both Google Cloud Platform and other Google APIs, the 2 libraries may be used by your application.