# Google Cloud Translation API . translations

## Instance Methods

Translates input text, returning translated text.

Translates input text, returning translated text.

### Method Details

`list(q, target, x__xgafv=None, source=None, format=None, cid=None, model=None)`

    Translates input text, returning translated text.

    Args:
      q: string, The input text to translate. Repeat this parameter to perform translation
    operations on multiple text inputs. (required) (repeated)
      target: string, The language to use for translation of the input text, set to one of the
    language codes listed in Language Support. (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format
      source: string, The language of the source text, set to one of the language codes listed in
    Language Support. If the source language is not specified, the API will
    attempt to identify the source language automatically and return it within
    the response.
      format: string, The format of the source text, in either HTML (default) or plain-text. A
    value of "html" indicates HTML and a value of "text" indicates plain-text.
        Allowed values
          html - Specifies the input is in HTML
          text - Specifies the input is in plain textual format
      cid: string, The customization id for translate (repeated)
      model: string, The `model` type requested for this translation. Valid values are
    listed in public documentation.

    Returns:
      An object of the form:

        { # The main language translation response message.
        "translations": [ # Translations contains list of translation results of given text
          {
            "translatedText": "A String", # Text translated into the target language.
            "model": "A String", # The `model` type used for this translation. Valid values are
                # listed in public documentation. Can be different from requested `model`.
                # Present only if specific model type was explicitly requested.
            "detectedSourceLanguage": "A String", # The source language of the initial request, detected automatically, if
                # no source language was passed within the initial request. If the
                # source language was passed, auto-detection of the language will not
                # occur and this field will be empty.
          },
        ],
      }

`translate(body, x__xgafv=None)`

    Translates input text, returning translated text.

    Args:
      body: object, The request body. (required)
        The object takes the form of:

    { # The main translation request message for the Cloud Translation API.
        "q": [ # The input text to translate. Repeat this parameter to perform translation
            # operations on multiple text inputs.
          "A String",
        ],
        "source": "A String", # The language of the source text, set to one of the language codes listed in
            # Language Support. If the source language is not specified, the API will
            # attempt to identify the source language automatically and return it within
            # the response.
        "model": "A String", # The `model` type requested for this translation. Valid values are
            # listed in public documentation.
        "target": "A String", # The language to use for translation of the input text, set to one of the
            # language codes listed in Language Support.
        "format": "A String", # The format of the source text, in either HTML (default) or plain-text. A
            # value of "html" indicates HTML and a value of "text" indicates plain-text.
      }

      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # The main language translation response message.
        "translations": [ # Translations contains list of translation results of given text
          {
            "translatedText": "A String", # Text translated into the target language.
            "model": "A String", # The `model` type used for this translation. Valid values are
                # listed in public documentation. Can be different from requested `model`.
                # Present only if specific model type was explicitly requested.
            "detectedSourceLanguage": "A String", # The source language of the initial request, detected automatically, if
                # no source language was passed within the initial request. If the
                # source language was passed, auto-detection of the language will not
                # occur and this field will be empty.
          },
        ],
      }