Class: Google::Cloud::Translate::Api
- Inherits:
-
Object
- Object
- Google::Cloud::Translate::Api
- Defined in:
- lib/google/cloud/translate/api.rb
Overview
Api
Represents top-level access to the Google Cloud Translation API. Translation API supports more than one hundred different languages, from Afrikaans to Zulu. Used in combination, this enables translation between thousands of language pairs. Also, you can send in HTML and receive HTML with translated text back. You don't need to extract your source text or reassemble the translated content.
Instance Method Summary collapse
-
#detect(*text) ⇒ Detection+
Detect the most likely language or languages of a text or multiple texts.
-
#languages(language = nil) ⇒ Array<Language>
List the languages supported by the API.
-
#project_id ⇒ Object
(also: #project)
The Cloud Translation API project connected to.
-
#translate(*text, to: nil, from: nil, format: nil, model: nil, cid: nil) ⇒ Translation+
Returns text translations from one language to another.
Instance Method Details
#detect(*text) ⇒ Detection+
Detect the most likely language or languages of a text or multiple texts.
223 224 225 226 227 228 |
# File 'lib/google/cloud/translate/api.rb', line 223 def detect *text return nil if text.empty? text = Array(text).flatten gapi = service.detect(text) Detection.from_gapi gapi, text end |
#languages(language = nil) ⇒ Array<Language>
List the languages supported by the API. These are the languages to and from which text can be translated.
266 267 268 269 270 |
# File 'lib/google/cloud/translate/api.rb', line 266 def languages language = nil language = language.to_s if language gapi = service.languages language Array(gapi["languages"]).map { |g| Language.from_gapi g } end |
#project_id ⇒ Object Also known as: project
The Cloud Translation API project connected to.
77 78 79 |
# File 'lib/google/cloud/translate/api.rb', line 77 def project_id service.project end |
#translate(*text, to: nil, from: nil, format: nil, model: nil, cid: nil) ⇒ Translation+
Returns text translations from one language to another.
174 175 176 177 178 179 180 181 182 183 184 185 |
# File 'lib/google/cloud/translate/api.rb', line 174 def translate *text, to: nil, from: nil, format: nil, model: nil, cid: nil return nil if text.empty? raise ArgumentError, "to is required" if to.nil? to = to.to_s from = from.to_s if from format = format.to_s if format text = Array(text).flatten gapi = service.translate text, to: to, from: from, format: format, model: model, cid: cid Translation.from_gapi_list gapi, text, to, from end |