gcloud 0.11.0 → 0.12.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    MTIzYjc5OWY0M2E1MGJkMTVlNWI5NmM4YTdkZDM3ZWRmZTgyZDRiZQ==
+    MTdmZDU0OTY4YzZmZjM4OTJkZTVmMDVkODg2NmVmNjIyZTdhNjY4ZA==
   data.tar.gz: !binary |-
-    Nzg1ZTExY2RhMDRlMDUzMzkyY2FkYTI4ODUyMDc3NTEyMjIzM2QyMw==
+    ZDFjMWNhZGJkMDNlM2YzODZhNWU2MGJmZGZjYWQ4YjU5N2ZkMzRjNg==
 SHA512:
   metadata.gz: !binary |-
-    YmFjZmQyMjU4NjRhZGM0Zjc4NDYxYmVjYTQyNzhhZGI1ZTAyZjBhYTBjMDZm
-    N2U5OWZkOTYzZDk1NjEyNzk0MjJiMTU1OTVlYjZiN2Q1MjhjMTMwYjg2M2U3
-    OWI2NWYxMjlmZGE2NDM2MDZjOWExYzIyNDhiMjEzOTE4ZWRjMjY=
+    ZDgwNjM1ZjNmYjg3YjI3NjJiYTA2NmNjN2JiYzU5MDllYzY3NGMzYTY0Yjg1
+    YTM4M2FkODM3MTNmYWUxZDViNTE0MTQzYjk5NTFmMGMzN2EyOWIzZmFmODVk
+    OTVjNTkzOWY2NGIzM2RmMzhiMDFlOGYzYjk2ZTA2ZjBjNDIyMzk=
   data.tar.gz: !binary |-
-    ZjgzNWI3NjA3ZWFkNmJjZWUxYWM1M2M3MGIxMzdmOTcxMTdlZjIzZjRiOGU3
-    Yzk1MWQ0ZDQzYjg0N2Y1MDI2MzhmM2VlNTA0NWY2NWYyMDAzMjU3YmE5YzM3
-    ZWI3MTkyMDU2M2YyYzMyYWQ0MTg0YWMwYzc4NWNlNTBmMThlNzU=
+    OGZmNGE2ODE4MDViM2MzNzc0ZjQ4YzZmNGRjZjUyZmViNjE1ZWY1OThlZmQx
+    Y2ZmOGEyZjVlMzFhMzZjODNlNDNhMjVmYzQ1ZGY3ZDQ2ZTBjZTRjMjQ5ODRk
+    NmY5YmQ0NWZiZDk1YzZlZjU0MmJlZGQzZWRhODRlMGQzOWI1ZWY=

data/AUTHENTICATION.md

@@ -2,7 +2,7 @@
 
 ## Creating a Service Account
 
-Gcloud aims to make authentication as simple as possible. Google Cloud requires a **Project ID** and **Service Account Credentials** to connect to the APIs. To create a service account:
+The gcloud-ruby library aims to make authentication as simple as possible. Google Cloud requires a **Project ID** and **Service Account Credentials** to connect to the APIs. To create a service account:
 
 1. Visit the [Google Developers Console Projects page](https://console.developers.google.com/project).
 1. Create a new project or click on an existing project that you wish to use.
@@ -18,11 +18,11 @@ Gcloud aims to make authentication as simple as possible. Google Cloud requires
 1. Under **New credentials**, select **Service account key**.
 1. If you want to create a new service account, under **Service account**, select **New service account**. Otherwise, select an existing service account. Submit the form to download a JSON type key. Save the downloaded JSON key file to authorize your requests.
 
-You will use the **Project ID** and **JSON file** to connect to services with gcloud.
+You will use the **Project ID** and **JSON file** to connect to services with gcloud-ruby.
 
 ## Project and Credential Lookup
 
-Gcloud aims to make authentication as simple as possible, and provides several mechanisms to configure your system without providing **Project ID** and **Service Account Credentials** directly in code.
+The gcloud-ruby library aims to make authentication as simple as possible, and provides several mechanisms to configure your system without providing **Project ID** and **Service Account Credentials** directly in code.
 
 **Project ID** is discovered in the following order:
 

data/CHANGELOG.md

@@ -1,5 +1,97 @@
 # Release History
 
+### 0.12.0 / 2016-07-25
+
+In addition to upgrading the `google-api-client` dependency to the latest version (a significant change in the HTTP stack), this release makes a number of small, breaking changes in anticipation of gcloud-ruby `1.0`.
+
+#### Changes
+
+* Core
+  * Upgrade Google API Client dependency to `0.9`
+  * Upgrade gRPC dependency to `1.0.0.pre1`
+  * Add optional arguments `retries` and `timeout` to service factories
+  * Remove `Gcloud::Error#inner`, use `#cause` instead
+  * Remove `Gcloud::Backoff`
+  * Remove `Gcloud::Upload`
+* BigQuery
+  * Replace `Bigquery::Error` and `Bigquery::ApiError` classes with `Gcloud::Error` classes
+  * Update `Dataset#access` to return a frozen `Dataset::Access` object (was array of hashes)
+  * Remove `Dataset#access=`, use `Dataset#access` with a block to make changes
+  * Update `Dataset#create_table` method
+    * Remove `schema` optional argument
+    * Add `fields` optional argument
+    * Yield `Table::Updater` instead of `Table::Schema`
+  * Remove erroneous `Dataset::Access` methods
+    * `Dataset::Access#add_owner_view`
+    * `Dataset::Access#add_writer_view`
+    * `Dataset::Access#remove_writer_view`
+    * `Dataset::Access#remove_owner_view`
+    * `Dataset::Access#writer_view?`
+    * `Dataset::Access#owner_view?`
+  * Remove erroneous `Job::List#total` accessor
+  * Remove erroneous `Project#access` method
+  * Move `Table::Schema` to `Schema`
+  * Update `Table#schema` to return a frozen `Schema` object (was hash)
+  * Remove `Table#schema=`, use `Table#schema` with a block to make changes
+  * Add `Schema::Field`
+  * Add `View#id` and `#query_id` methods, to match `Table`
+  * Add `Dataset::Updater` class
+  * Add `Table::Updater` class
+  * Remove `Table#load` optional argument `chunk_size`
+* Datastore
+  * Replace `Datastore::Error` and `Datastore::KeyfileError` classes with `Gcloud::Error` classes
+  * Add `KeyError` class
+  * Remove `TransactionError#commit_error` and `#transaction_error` methods, use `#cause` instead
+  * Add `Entity#serialized_size` method
+  * Add `Key#serialized_size` method
+  * Update documentation for emulator (pcostell)
+* DNS
+  * Replace `Dns::Error` and `Dns::ApiError` classes with `Gcloud::Error` classes
+* Logging
+  * Update `Project#entry` with convenient optional arguments
+  * Add `Entry#resource=` method
+  * Add `Entry` severity convenience methods
+    * `Entry#default!`
+    * `Entry#debug!`
+    * `Entry#info!`
+    * `Entry#notice!`
+    * `Entry#warning!`
+    * `Entry#error!`
+    * `Entry#critical!`
+    * `Entry#alert!`
+    * `Entry#emergency!`
+* Pub/Sub
+  * Add `Policy` class
+  * Update `Topic#policy` to yield a `Policy` object to be updated
+  * Update `Topic#policy`/`#policy=` to return/receive `Policy` object (was hash)
+  * Update `Subscription#policy` to yield a `Policy` object to be updated
+  * Update `Subscription#policy`/`#policy=` to return/receive `Policy` object (was hash)
+  * Rename `Topic::Batch` to `Topic::Publisher`
+* Resource Manager
+  * Upgrade to `V1` API
+  * Add `Policy` class
+  * Update `Project#policy` to yield a `Policy` object to be updated
+  * Update `Project#policy`/`#policy=` to return/receive `Policy` object (was hash)
+* Storage
+  * Replace `Storage::Error` and `Storage::ApiError` classes with `Gcloud::Error` classes
+  * Update `Project#create_bucket`
+    * Yield `Bucket::Updater` object instead of a `Bucket::Cors` object
+    * Remove `cors` optional argument
+  * Remove `Bucket#create_file` optional argument `chunk_size`
+  * Remove `Bucket#cors=`, use `Bucket#cors` with a block to make changes
+  * Add `Bucket::Cors::Rule` class
+  * Remove erroneous `Bucket::DefaultAcl` methods
+    * `Bucket::DefaultAcl#writers`
+    * `Bucket::DefaultAcl#add_writer`
+  * Remove erroneous `File::Acl` methods
+    * `File::Acl#writers`
+    * `File::Acl#add_writer`
+* Translate
+  * Replace `Translate::Error` and `Translate::ApiError` classes with `Gcloud::Error` classes
+* Vision
+  * Replace `Vision::Error` and `Vision::ApiError` classes with `Gcloud::Error` classes
+
+
 ### 0.11.0 / 2016-06-13
 
 #### Changes

data/OVERVIEW.md

@@ -1,12 +1,12 @@
 # Getting started
 
-The `gcloud` library is installable through rubygems:
+The gcloud-ruby library is installable through rubygems:
 
 ```sh
 $ gem install gcloud
 ```
 
-Gcloud aims to make authentication as simple as possible. Google Cloud requires a **Project ID** and **Service Account Credentials** to connect to the APIs. You can learn more about various options for connection on the [Authentication Guide](https://googlecloudplatform.github.io/gcloud-ruby/#/docs/guides/authentication).
+The gcloud-ruby library aims to make authentication as simple as possible. Google Cloud requires a **Project ID** and **Service Account Credentials** to connect to the APIs. You can learn more about various options for connection on the [Authentication Guide](https://googlecloudplatform.github.io/gcloud-ruby/#/docs/guides/authentication).
 
 # BigQuery
 
@@ -99,7 +99,7 @@ end
 
 # Logging
 
-[Google Cloud Logging](https://cloud.google.com/logging/) collects and stores logs from applications and services on the Google Cloud Platform, giving you fine-grained, programmatic control over your projects' logs. With this API you can do the following:
+[Stackdriver Logging](https://cloud.google.com/logging/) collects and stores logs from applications and services on the Google Cloud Platform, giving you fine-grained, programmatic control over your projects' logs. With this API you can do the following:
 
 * Read and filter log entries
 * Export your log entries to Cloud Storage,

data/lib/gcloud.rb

@@ -18,12 +18,13 @@ require "gcloud/version"
 ##
 # # Google Cloud
 #
-# Gcloud is the official library for interacting with the Google Cloud Platform.
-# Google Cloud Platform is a set of modular cloud-based services that allow
-# you to create anything from simple websites to complex applications.
+# The gcloud-ruby library is the official library for interacting with Google
+# Cloud Platform. Google Cloud Platform is a set of modular cloud-based services
+# that allow you to create anything from simple websites to complex
+# applications.
 #
-# Gcloud's goal is to provide a API that is familiar and comfortable to
-# Rubyists. Authentication is handled by providing project and credential
+# The goal of gcloud-ruby is to provide a API that is familiar and comfortable
+# to Rubyists. Authentication is handled by providing project and credential
 # information, or if you are running on Google Compute Engine this configuration
 # is taken care of for you.
 #
@@ -41,6 +42,9 @@ module Gcloud
   #   connecting to.
   # @param [String, Hash] keyfile Keyfile downloaded from Google Cloud. If file
   #   path the file must be readable.
+  # @param [Integer] retries Number of times to retry requests on server error.
+  #   The default value is `3`. Optional.
+  # @param [Integer] timeout Default timeout to use in requests. Optional.
   #
   # @return [Gcloud]
   #
@@ -52,10 +56,12 @@ module Gcloud
   #   pubsub  = gcloud.pubsub
   #   storage = gcloud.storage
   #
-  def self.new project = nil, keyfile = nil
+  def self.new project = nil, keyfile = nil, retries: nil, timeout: nil
     gcloud = Object.new
     gcloud.instance_variable_set "@project", project
     gcloud.instance_variable_set "@keyfile", keyfile
+    gcloud.instance_variable_set "@retries", retries
+    gcloud.instance_variable_set "@timeout", timeout
     gcloud.extend Gcloud
     gcloud
   end
@@ -75,6 +81,9 @@ module Gcloud
   #   The default scope is:
   #
   #   * `https://www.googleapis.com/auth/datastore`
+  # @param [Integer] retries Number of times to retry requests on server error.
+  #   The default value is `3`. Optional.
+  # @param [Integer] timeout Default timeout to use in requests. Optional.
   #
   # @return [Gcloud::Datastore::Dataset]
   #
@@ -100,9 +109,11 @@ module Gcloud
   #   platform_scope = "https://www.googleapis.com/auth/cloud-platform"
   #   datastore = gcloud.datastore scope: platform_scope
   #
-  def datastore scope: nil
+  def datastore scope: nil, retries: nil, timeout: nil
     require "gcloud/datastore"
-    Gcloud.datastore @project, @keyfile, scope: scope
+    Gcloud.datastore @project, @keyfile, scope: scope,
+                                         retries: (retries || @retries),
+                                         timeout: (timeout || @timeout)
   end
 
   ##
@@ -123,6 +134,9 @@ module Gcloud
   #   The default scope is:
   #
   #   * `https://www.googleapis.com/auth/devstorage.full_control`
+  # @param [Integer] retries Number of times to retry requests on server error.
+  #   The default value is `3`. Optional.
+  # @param [Integer] timeout Default timeout to use in requests. Optional.
   #
   # @return [Gcloud::Storage::Project]
   #
@@ -141,9 +155,11 @@ module Gcloud
   #   readonly_scope = "https://www.googleapis.com/auth/devstorage.read_only"
   #   readonly_storage = gcloud.storage scope: readonly_scope
   #
-  def storage scope: nil
+  def storage scope: nil, retries: nil, timeout: nil
     require "gcloud/storage"
-    Gcloud.storage @project, @keyfile, scope: scope
+    Gcloud.storage @project, @keyfile, scope: scope,
+                                       retries: (retries || @retries),
+                                       timeout: (timeout || @timeout)
   end
 
   ##
@@ -161,6 +177,9 @@ module Gcloud
   #   The default scope is:
   #
   #   * `https://www.googleapis.com/auth/pubsub`
+  # @param [Integer] retries Number of times to retry requests on server error.
+  #   The default value is `3`. Optional.
+  # @param [Integer] timeout Default timeout to use in requests. Optional.
   #
   # @return [Gcloud::Pubsub::Project]
   #
@@ -179,9 +198,11 @@ module Gcloud
   #   platform_scope = "https://www.googleapis.com/auth/cloud-platform"
   #   pubsub = gcloud.pubsub scope: platform_scope
   #
-  def pubsub scope: nil
+  def pubsub scope: nil, retries: nil, timeout: nil
     require "gcloud/pubsub"
-    Gcloud.pubsub @project, @keyfile, scope: scope
+    Gcloud.pubsub @project, @keyfile, scope: scope,
+                                      retries: (retries || @retries),
+                                      timeout: (timeout || @timeout)
   end
 
   ##
@@ -199,6 +220,9 @@ module Gcloud
   #   The default scope is:
   #
   #   * `https://www.googleapis.com/auth/bigquery`
+  # @param [Integer] retries Number of times to retry requests on server error.
+  #   The default value is `3`. Optional.
+  # @param [Integer] timeout Default request timeout in seconds. Optional.
   #
   # @return [Gcloud::Bigquery::Project]
   #
@@ -220,9 +244,11 @@ module Gcloud
   #   platform_scope = "https://www.googleapis.com/auth/cloud-platform"
   #   bigquery = gcloud.bigquery scope: platform_scope
   #
-  def bigquery scope: nil
+  def bigquery scope: nil, retries: nil, timeout: nil
     require "gcloud/bigquery"
-    Gcloud.bigquery @project, @keyfile, scope: scope
+    Gcloud.bigquery @project, @keyfile, scope: scope,
+                                        retries: (retries || @retries),
+                                        timeout: (timeout || @timeout)
   end
 
   ##
@@ -240,6 +266,9 @@ module Gcloud
   #   The default scope is:
   #
   #   * `https://www.googleapis.com/auth/ndev.clouddns.readwrite`
+  # @param [Integer] retries Number of times to retry requests on server error.
+  #   The default value is `3`. Optional.
+  # @param [Integer] timeout Default timeout to use in requests. Optional.
   #
   # @return [Gcloud::Dns::Project]
   #
@@ -260,9 +289,11 @@ module Gcloud
   #   readonly_scope = "https://www.googleapis.com/auth/ndev.clouddns.readonly"
   #   dns = gcloud.dns scope: readonly_scope
   #
-  def dns scope: nil
+  def dns scope: nil, retries: nil, timeout: nil
     require "gcloud/dns"
-    Gcloud.dns @project, @keyfile, scope: scope
+    Gcloud.dns @project, @keyfile, scope: scope,
+                                   retries: (retries || @retries),
+                                   timeout: (timeout || @timeout)
   end
 
   # rubocop:disable Metrics/LineLength
@@ -284,6 +315,9 @@ module Gcloud
   #   The default scope is:
   #
   #   * `https://www.googleapis.com/auth/cloud-platform`
+  # @param [Integer] retries Number of times to retry requests on server error.
+  #   The default value is `3`. Optional.
+  # @param [Integer] timeout Default timeout to use in requests. Optional.
   #
   # @return [Gcloud::ResourceManager::Manager]
   #
@@ -303,15 +337,17 @@ module Gcloud
   #   readonly_scope = "https://www.googleapis.com/auth/cloudresourcemanager.readonly"
   #   resource_manager = gcloud.resource_manager scope: readonly_scope
   #
-  def resource_manager scope: nil
+  def resource_manager scope: nil, retries: nil, timeout: nil
     require "gcloud/resource_manager"
-    Gcloud.resource_manager @keyfile, scope: scope
+    Gcloud.resource_manager @keyfile, scope: scope,
+                                      retries: (retries || @retries),
+                                      timeout: (timeout || @timeout)
   end
 
   # rubocop:enable Metrics/LineLength
 
   ##
-  # Creates a new object for connecting to the Logging service.
+  # Creates a new object for connecting to the Stackdriver Logging service.
   # Each call creates a new connection.
   #
   # For more information on connecting to Google Cloud see the [Authentication
@@ -325,6 +361,9 @@ module Gcloud
   #   The default scope is:
   #
   #   * `https://www.googleapis.com/auth/logging.admin`
+  # @param [Integer] retries Number of times to retry requests on server error.
+  #   The default value is `3`. Optional.
+  # @param [Integer] timeout Default timeout to use in requests. Optional.
   #
   # @return [Gcloud::Logging::Project]
   #
@@ -342,9 +381,11 @@ module Gcloud
   #   platform_scope = "https://www.googleapis.com/auth/cloud-platform"
   #   logging = gcloud.logging scope: platform_scope
   #
-  def logging scope: nil
+  def logging scope: nil, retries: nil, timeout: nil
     require "gcloud/logging"
-    Gcloud.logging @project, @keyfile, scope: scope
+    Gcloud.logging @project, @keyfile, scope: scope,
+                                       retries: (retries || @retries),
+                                       timeout: (timeout || @timeout)
   end
 
   ##
@@ -360,6 +401,9 @@ module Gcloud
   # keys](https://cloud.google.com/translate/v2/using_rest#creating-server-api-keys).
   #
   # @param [String] key a public API access key (not an OAuth 2.0 token)
+  # @param [Integer] retries Number of times to retry requests on server error.
+  #   The default value is `3`. Optional.
+  # @param [Integer] timeout Default timeout to use in requests. Optional.
   #
   # @return [Gcloud::Translate::Api]
   #
@@ -383,9 +427,10 @@ module Gcloud
   #   translation = translate.translate "Hello world!", to: "la"
   #   translation.text #=> "Salve mundi!"
   #
-  def translate key = nil
+  def translate key = nil, retries: nil, timeout: nil
     require "gcloud/translate"
-    Gcloud.translate key
+    Gcloud.translate key, retries: (retries || @retries),
+                          timeout: (timeout || @timeout)
   end
 
   ##
@@ -400,6 +445,9 @@ module Gcloud
   #   The default scope is:
   #
   #   * `https://www.googleapis.com/auth/cloud-platform`
+  # @param [Integer] retries Number of times to retry requests on server error.
+  #   The default value is `3`. Optional.
+  # @param [Integer] timeout Default timeout to use in requests. Optional.
   #
   # @return [Gcloud::Vision::Project]
   #
@@ -421,8 +469,10 @@ module Gcloud
   #   platform_scope = "https://www.googleapis.com/auth/cloud-platform"
   #   vision = gcloud.vision scope: platform_scope
   #
-  def vision scope: nil
+  def vision scope: nil, retries: nil, timeout: nil
     require "gcloud/vision"
-    Gcloud.vision @project, @keyfile, scope: scope
+    Gcloud.vision @project, @keyfile, scope: scope,
+                                      retries: (retries || @retries),
+                                      timeout: (timeout || @timeout)
   end
 end

data/lib/gcloud/backoff.rb

@@ -15,6 +15,7 @@
 
 module Gcloud
   ##
+  # @private
   # Backoff allows users to control how Google API calls are retried.
   # If an API call fails the response will be checked to see if the
   # call can be retried. If the response matches the criteria, then it
@@ -34,7 +35,10 @@ module Gcloud
       # The number of times a retriable API call should be retried.
       #
       # The default value is `3`.
-      attr_accessor :retries
+      attr_reader :retries
+      def retries= new_retries
+        @retries = new_retries
+      end
 
       ##
       # The GRPC Status Codes that should be retried.

data/lib/gcloud/bigquery.rb

@@ -36,6 +36,9 @@ module Gcloud
   #   The default scope is:
   #
   #   * `https://www.googleapis.com/auth/bigquery`
+  # @param [Integer] retries Number of times to retry requests on server error.
+  #   The default value is `3`. Optional.
+  # @param [Integer] timeout Default timeout to use in requests. Optional.
   #
   # @return [Gcloud::Bigquery::Project]
   #
@@ -46,14 +49,21 @@ module Gcloud
   #   dataset = bigquery.dataset "my_dataset"
   #   table = dataset.table "my_table"
   #
-  def self.bigquery project = nil, keyfile = nil, scope: nil
+  def self.bigquery project = nil, keyfile = nil, scope: nil, retries: nil,
+                    timeout: nil
     project ||= Gcloud::Bigquery::Project.default_project
+    project = project.to_s # Always cast to a string
+    fail ArgumentError, "project is missing" if project.empty?
+
     if keyfile.nil?
       credentials = Gcloud::Bigquery::Credentials.default scope: scope
     else
       credentials = Gcloud::Bigquery::Credentials.new keyfile, scope: scope
     end
-    Gcloud::Bigquery::Project.new project, credentials
+
+    Gcloud::Bigquery::Project.new(
+      Gcloud::Bigquery::Service.new(
+        project, credentials, retries: retries, timeout: timeout))
   end
 
   ##
@@ -64,8 +74,8 @@ module Gcloud
   # more, read [What is
   # BigQuery?](https://cloud.google.com/bigquery/what-is-bigquery).
   #
-  # Gcloud's goal is to provide an API that is familiar and comfortable to
-  # Rubyists. Authentication is handled by {Gcloud#bigquery}. You can provide
+  # The goal of gcloud-ruby is to provide an API that is comfortable
+  # to Rubyists. Authentication is handled by {Gcloud#bigquery}. You can provide
   # the project and credential information to connect to the BigQuery service,
   # or if you are running on Google Compute Engine this configuration is taken
   # care of for you. You can read more about the options for connecting in the
@@ -311,33 +321,6 @@ module Gcloud
   # default format for load operations, the option is not actually necessary.
   # For JSON saved with a `.txt` extension, however, it would be.
   #
-  # ### A note about large uploads
-  #
-  # You may encounter a Broken pipe (`Errno::EPIPE`) error when attempting to
-  # upload large files. To avoid this problem, add the
-  # [httpclient](https://rubygems.org/gems/httpclient) gem to your project, and
-  # the line (or lines) of configuration shown below. These lines must execute
-  # after you require gcloud but before you make your first gcloud connection.
-  # The first statement configures [Faraday](https://rubygems.org/gems/faraday)
-  # to use httpclient. The second statement, which should only be added if you
-  # are using a version of Faraday at or above 0.9.2, is a workaround for [this
-  # gzip issue](https://github.com/GoogleCloudPlatform/gcloud-ruby/issues/367).
-  #
-  # ```ruby
-  # require "gcloud"
-  #
-  # # Use httpclient to avoid broken pipe errors with large uploads
-  # Faraday.default_adapter = :httpclient
-  #
-  # # Only add the following statement if using Faraday >= 0.9.2
-  # # Override gzip middleware with no-op for httpclient
-  # Faraday::Response.register_middleware :gzip =>
-  #                                         Faraday::Response::Middleware
-  #
-  # gcloud = Gcloud.new
-  # bigquery = gcloud.bigquery
-  # ```
-  #
   # ## Exporting query results to Google Cloud Storage
   #
   # The example below shows how to pass the `table` option with a query in order
@@ -386,24 +369,23 @@ module Gcloud
   # BigQuery](https://cloud.google.com/bigquery/exporting-data-from-bigquery)
   # for details.
   #
-  # ## Configuring Backoff
+  # ## Configuring retries and timeout
   #
-  # The {Gcloud::Backoff} class allows users to globally configure how Cloud API
-  # requests are automatically retried in the case of some errors, such as a
-  # `500` or `503` status code, or a specific internal error code such as
-  # `rateLimitExceeded`.
+  # You can configure how many times API requests may be automatically retried.
+  # When an API request fails, the response will be inspected to see if the
+  # request meets criteria indicating that it may succeed on retry, such as
+  # `500` and `503` status codes or a specific internal error code such as
+  # `rateLimitExceeded`. If it meets the criteria, the request will be retried
+  # after a delay. If another error occurs, the delay will be increased before a
+  # subsequent attempt, until the `retries` limit is reached.
   #
-  # If an API call fails, the response will be inspected to see if the call
-  # should be retried. If the response matches the criteria, then the request
-  # will be retried after a delay. If another error occurs, the delay will be
-  # increased incrementally before a subsequent attempt. The first retry will be
-  # delayed one second, the second retry two seconds, and so on.
+  # You can also set the request `timeout` value in seconds.
   #
   # ```ruby
   # require "gcloud"
-  # require "gcloud/backoff"
   #
-  # Gcloud::Backoff.retries = 5 # Raise the maximum number of retries from 3
+  # gcloud = Gcloud.new
+  # bigquery = gcloud.bigquery retries: 10, timeout: 120
   # ```
   #
   # See the [BigQuery error