Module: Google::Cloud

Defined in:

lib/google-cloud-translate.rb,
lib/google/cloud/translate.rb,
lib/google/cloud/translate/api.rb,
lib/google/cloud/translate/service.rb,
lib/google/cloud/translate/version.rb,
lib/google/cloud/translate/language.rb,
lib/google/cloud/translate/detection.rb,
lib/google/cloud/translate/credentials.rb,
lib/google/cloud/translate/translation.rb

Defined Under Namespace

Modules: Translate

Class Method Summary

• .translate(key = nil, project: nil, keyfile: nil, scope: nil, retries: nil, timeout: nil) ⇒ Google::Cloud::Translate::Api

  Creates a new object for connecting to the Translate service.

Instance Method Summary

• #translate(key = nil, scope: nil, retries: nil, timeout: nil) ⇒ Google::Cloud::Translate::Api

  Creates a new object for connecting to the Translate service.

Class Method Details

.translate(key = nil, project: nil, keyfile: nil, scope: nil, retries: nil, timeout: nil) ⇒ Google::Cloud::Translate::Api

Creates a new object for connecting to the Translate service. Each call creates a new connection.

Like other Cloud Platform services, Google Translate API supports authentication using a project ID and OAuth 2.0 credentials. In addition, it supports authentication using a public API access key. (If both the API key and the project and OAuth 2.0 credentials are provided, the API key will be used.) Instructions and configuration options are covered in the Authentication Guide.

Examples:

require "google/cloud"

translate = Google::Cloud.translate "api-key-abc123XYZ789"

translation = translate.translate "Hello world!", to: "la"
translation.text #=> "Salve mundi!"

Using API Key from the environment variable.

require "google/cloud"

ENV["TRANSLATE_KEY"] = "api-key-abc123XYZ789"

translate = Google::Cloud.translate

translation = translate.translate "Hello world!", to: "la"
translation.text #=> "Salve mundi!"

Parameters:

• key (String) (defaults to: nil) —

  a public API access key (not an OAuth 2.0 token)

• project (String) —

  Project identifier for the Translate service you are connecting to.

• keyfile (String, Hash) —

  Keyfile downloaded from Google Cloud. If file path the file must be readable.

• scope (String, Array<String>) —

  The OAuth 2.0 scopes controlling the set of resources and operations that the connection can access. See Using OAuth 2.0 to Access Google APIs.

  The default scope is:

  • https://www.googleapis.com/auth/cloud-platform
• retries (Integer) —

  Number of times to retry requests on server error. The default value is 3. Optional.

• timeout (Integer) —

  Default timeout to use in requests. Optional.

Returns:

• (Google::Cloud::Translate::Api)

# File 'lib/google-cloud-translate.rb', line 127

def self.translate key = nil, project: nil, keyfile: nil, scope: nil,
                   retries: nil, timeout: nil
  require "google/cloud/translate"
  Google::Cloud::Translate.new key: key, project: project, keyfile: keyfile,
                               scope: scope, retries: retries,
                               timeout: timeout
end

Instance Method Details

#translate(key = nil, scope: nil, retries: nil, timeout: nil) ⇒ Google::Cloud::Translate::Api

Creates a new object for connecting to the Translate service. Each call creates a new connection.

Like other Cloud Platform services, Google Translate API supports authentication using a project ID and OAuth 2.0 credentials. In addition, it supports authentication using a public API access key. (If both the API key and the project and OAuth 2.0 credentials are provided, the API key will be used.) Instructions and configuration options are covered in the Authentication Guide.

Examples:

require "google/cloud"

gcloud = Google::Cloud.new
translate = gcloud.translate "api-key-abc123XYZ789"

translation = translate.translate "Hello world!", to: "la"
translation.text #=> "Salve mundi!"

Using API Key from the environment variable.

require "google/cloud"

ENV["TRANSLATE_KEY"] = "api-key-abc123XYZ789"

gcloud = Google::Cloud.new
translate = gcloud.translate

translation = translate.translate "Hello world!", to: "la"
translation.text #=> "Salve mundi!"

Parameters:

• key (String) (defaults to: nil) —

  a public API access key (not an OAuth 2.0 token)

• scope (String, Array<String>) —

  The OAuth 2.0 scopes controlling the set of resources and operations that the connection can access. See Using OAuth 2.0 to Access Google APIs.

  The default scope is:

  • https://www.googleapis.com/auth/cloud-platform
• retries (Integer) —

  Number of times to retry requests on server error. The default value is 3. Optional.

• timeout (Integer) —

  Default timeout to use in requests. Optional.

Returns:

• (Google::Cloud::Translate::Api)

# File 'lib/google-cloud-translate.rb', line 72

def translate key = nil, scope: nil, retries: nil, timeout: nil
  Google::Cloud.translate key, project: @project, keyfile: @keyfile,
                               scope: scope,
                               retries: (retries || @retries),
                               timeout: (timeout || @timeout)
end