google-cloud-core - Module Google::Cloud (v1.7.0)

Reference documentation and code samples for the google-cloud-core module Google::Cloud.

Methods

.configure

def self.configure() -> Google::Cloud::Config

Configure the default parameter for Google::Cloud. The values defined on this top level will be shared across all Google::Cloud libraries, which may also add fields to this object or add sub configuration options under this object.

Possible configuration parameters:

  • project_id: The Google Cloud Project ID. Automatically discovered when running from GCP environments.
  • credentials: The service account JSON file path. Automatically discovered when running from GCP environments.
  • on_error: A Proc to be run when an error is encountered during on a background thread. The Proc must take the error object as the single argument.
Yields
  • (@config)
Returns

.new

def self.new(project_id = nil, credentials = nil, retries: nil, timeout: nil) -> Google::Cloud

Creates a new object for connecting to Google Cloud.

For more information on connecting to Google Cloud see the Authentication Guide.

Parameters
  • project_id (String) — Project identifier for the service you are connecting to.
  • credentials (String, Hash, Google::Auth::Credentials) — The path to the keyfile as a String, the contents of the keyfile as a Hash, or a Google::Auth::Credentials object.
  • retries (Integer) (defaults to: nil) — Number of times to retry requests on server error. The default value is 3. Optional.
  • timeout (Integer) (defaults to: nil) — Default timeout to use in requests. Optional.
Returns
Example
require "google/cloud"

gcloud  = Google::Cloud.new
datastore = gcloud.datastore
pubsub  = gcloud.pubsub
storage = gcloud.storage