airflow.providers.google.cloud.hooks.translate
¶
This module contains a Google Cloud Translate Hook.
Module Contents¶
Classes¶
Hook for Google Cloud translate APIs. |
- class airflow.providers.google.cloud.hooks.translate.CloudTranslateHook(gcp_conn_id='google_cloud_default', impersonation_chain=None, **kwargs)[source]¶
Bases:
airflow.providers.google.common.hooks.base_google.GoogleBaseHook
Hook for Google Cloud translate APIs.
All the methods in the hook where project_id is used must be called with keyword arguments rather than positional.
- get_conn()[source]¶
Retrieve connection to Cloud Translate.
- Returns
Google Cloud Translate client object.
- Return type
google.cloud.translate_v2.Client
- translate(values, target_language, format_=None, source_language=None, model=None)[source]¶
Translate a string or list of strings.
See https://cloud.google.com/translate/docs/translating-text
- Parameters
values (str | list[str]) – 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 – (Optional) One of
text
orhtml
, to specify if the input text is plain text or HTML.source_language (str | None) – (Optional) The language of the text to be translated.
model (str | list[str] | None) – (Optional) The model used to translate the text, such as
'base'
or'nmt'
.
- 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.- Return type