:mod:`airflow.contrib.hooks.gcp_translate_hook`
===============================================

.. py:module:: airflow.contrib.hooks.gcp_translate_hook


Module Contents
---------------

.. py:class:: CloudTranslateHook(gcp_conn_id='google_cloud_default')

   Bases: :class:`airflow.contrib.hooks.gcp_api_base_hook.GoogleCloudBaseHook`

   Hook for Google Cloud translate APIs.

   .. attribute:: _client
      

   .. method:: get_conn(self)

      Retrieves connection to Cloud Translate

      :return: Google Cloud Translate client object.
      :rtype: google.cloud.translate_v2.Client


   .. method:: translate(self, values, target_language, format_=None, source_language=None, model=None)

      Translate a string or list of strings.

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

      :type values: str or list
      :param values: String or list of strings to translate.

      :type target_language: str
      :param target_language: The language to translate results into. This
                              is required by the API and defaults to
                              the target language of the current instance.

      :type format_: str
      :param format_: (Optional) One of ``text`` or ``html``, to specify
                      if the input text is plain text or HTML.

      :type source_language: str or None
      :param source_language: (Optional) The language of the text to
                              be translated.

      :type model: str or None
      :param model: (Optional) The model used to translate the text, such
                    as ``'base'`` or ``'nmt'``.

      :rtype: str 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: :class:`~exceptions.ValueError` if the number of
               values and translations differ.