| :mod:`airflow.contrib.operators.gcp_translate_speech_operator` |
| ============================================================== |
| |
| .. py:module:: airflow.contrib.operators.gcp_translate_speech_operator |
| |
| |
| Module Contents |
| --------------- |
| |
| .. py:class:: GcpTranslateSpeechOperator(audio, config, target_language, format_, source_language, model, project_id=None, gcp_conn_id='google_cloud_default', *args, **kwargs) |
| |
| Bases: :class:`airflow.models.BaseOperator` |
| |
| Recognizes speech in audio input and translates it. |
| |
| Note that it uses the first result from the recognition api response - the one with the highest confidence |
| In order to see other possible results please use |
| :ref:`howto/operator:GcpSpeechToTextRecognizeSpeechOperator` |
| and |
| :ref:`howto/operator:CloudTranslateTextOperator` |
| separately |
| |
| .. seealso:: |
| For more information on how to use this operator, take a look at the guide: |
| :ref:`howto/operator:GcpTranslateSpeechOperator` |
| |
| See https://cloud.google.com/translate/docs/translating-text |
| |
| Execute method returns string object with the translation |
| |
| This is a list of dictionaries queried value. |
| 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. |
| |
| Dictionary is set as XCom return value. |
| |
| :param audio: audio data to be recognized. See more: |
| https://googleapis.github.io/google-cloud-python/latest/speech/gapic/v1/types.html#google.cloud.speech_v1.types.RecognitionAudio |
| :type audio: dict or google.cloud.speech_v1.types.RecognitionAudio |
| |
| :param config: information to the recognizer that specifies how to process the request. See more: |
| https://googleapis.github.io/google-cloud-python/latest/speech/gapic/v1/types.html#google.cloud.speech_v1.types.RecognitionConfig |
| :type config: dict or google.cloud.speech_v1.types.RecognitionConfig |
| |
| :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. |
| Check the list of available languages here: https://cloud.google.com/translate/docs/languages |
| :type target_language: str |
| |
| :param format_: (Optional) One of ``text`` or ``html``, to specify |
| if the input text is plain text or HTML. |
| :type format_: str or None |
| |
| :param source_language: (Optional) The language of the text to |
| be translated. |
| :type source_language: str or None |
| |
| :param model: (Optional) The model used to translate the text, such |
| as ``'base'`` or ``'nmt'``. |
| :type model: str or None |
| |
| :param project_id: Optional, Google Cloud Platform Project ID where the Compute |
| Engine Instance exists. If set to None or missing, the default project_id from the GCP connection is |
| used. |
| :type project_id: str |
| |
| :param gcp_conn_id: Optional, The connection ID used to connect to Google Cloud |
| Platform. Defaults to 'google_cloud_default'. |
| :type gcp_conn_id: str |
| |
| .. attribute:: template_fields |
| :annotation: = ['target_language', 'format_', 'source_language', 'model', 'project_id', 'gcp_conn_id'] |
| |
| |
| |
| |
| .. method:: execute(self, context) |
| |
| |
| |
| |