Translation Client

Client for interacting with the Google Cloud Translation API.

google.cloud.translate_v2.client.BASE( = 'base )

Base translation model.

class google.cloud.translate_v2.client.Client(target_language='en', credentials=None, _http=None, client_info=None, client_options=None)

Bases: google.cloud.client.Client

Client to bundle configuration needed for API requests.

• Parameters

  • target_language( str ) – (Optional) The target language used for translations and language names. (Defaults to ENGLISH_ISO_639 .)

  • credentials( Credentials ) – (Optional) The OAuth2 Credentials to use for this client. If not passed (and if no _http object is passed), falls back to the default inferred from the environment.

  • _http( Session ) – (Optional) HTTP object to make requests. Can be any object that defines request() with the same interface as requests.Session.request() . If not passed, an _http object is created that is bound to the credentials for the current object. This parameter should be considered private, and could change in the future.

  • client_info( ClientInfo ) – The client info used to send a user-agent string along with API requests. If None , then default info will be used. Generally, you only need to set this if you’re developing your own library or partner tool.

  • client_options( ClientOptions or dict ) – (Optional) Client options used to set user options on the client. API Endpoint should be set through client_options.

SCOPE( : Union[Tuple[ str , ...], None = (' https://www.googleapis.com/auth/cloud-platform ', )

The scopes required for authenticating.

detect_language(values)

Detect the language of a string or list of strings.

See https://cloud.google.com/translate/docs/detecting-language

• Parameters

  values( str * or [ list*]( https://docs.python.org/3/library/stdtypes.html#list )) – String or list of strings that will have language detected.

• Return type

  dict or list

• Returns

  A list of dictionaries for each queried value. Each dictionary typically contains three keys

  • confidence : The confidence in language detection, a float between 0 and 1.

  • input : The corresponding input value.

  • language : The detected language (as an ISO 639-1 language code).

    though the key confidence may not always be present.

    If only a single value is passed, then only a single dictionary will be returned.

• Raises

  ValueError if the number of detections is not equal to the number of values. ValueError if a value produces a list of detections with 0 or multiple results in it.

get_languages(target_language=None)

Get list of supported languages for translation.

Response

See https://cloud.google.com/translate/docs/discovering-supported-languages

• Parameters

  target_language( str ) – (Optional) The language used to localize returned language names. Defaults to the target language on the current client.

• Return type

  list

• Returns

  List of dictionaries. Each dictionary contains a supported ISO 639-1 language code (using the dictionary key language ). If target_language is passed, each dictionary will also contain the name of each supported language (localized to the target language).

translate(values, target_language=None, format_=None, source_language=None, customization_ids=(), model=None)

Translate a string or list of strings.

See https://cloud.google.com/translate/docs/translating-text

• Parameters

  • values( str * or [ list*]( https://docs.python.org/3/library/stdtypes.html#list )) – String or list of strings to translate.

  • target_language( str ) – The language to translate results into. This is required by the API and defaults to the target language of the current instance.

  • format( str ) – (Optional) One of text or html , to specify if the input text is plain text or HTML.

  • source_language( str ) – (Optional) The language of the text to be translated.

  • customization_ids( str * or [ list*]( https://docs.python.org/3/library/stdtypes.html#list )) – (Optional) ID or list of customization IDs for translation. Sets the cid parameter in the query.

  • model( str ) – (Optional) The model used to translate the text, such as 'base' or 'nmt' .

• Return type

  dict or list

• Returns

  A list of dictionaries for each queried value. Each dictionary typically contains three keys (though not all will be present in all cases)

  • detectedSourceLanguage : The detected language (as an ISO 639-1 language code) of the text.

  • translatedText : The translation of the text into the target language.

  • input : The corresponding input value.

  • model : The model used to translate the text.

    If only a single value is passed, then only a single dictionary will be returned.

• Raises

  ValueError if the number of values and translations differ.

google.cloud.translate_v2.client.ENGLISH_ISO_639( = 'en )

ISO 639-1 language code for English.

google.cloud.translate_v2.client.NMT( = 'nmt )

Neural Machine Translation model.