GetTranslations Element

In This Topic

Namespace

http://api.microsofttranslator.com/V2

Diagram

Overview

GetTranslations

Sequence

appId optional xs:string

A string containing "Bearer" + " " + access token.

text optional xs:string

A string representing the text to split into sentences. The size of the text must not exceed 10000 characters.

from optional xs:string

A string containing the language code of the source language. Must be a valid culture name.

to optional xs:string

A string containing the language code of the target language. Must be a valid culture name.

maxTranslations optional xs:int

An int representing the maximum number of translations to return.

options optional TranslateOptions Complex Type

A TranslateOptions object which contains the values listed below. They are all optional and default to the most common settings.

Category: A string containing the category (domain) of the translation. Defaults to "general".
ContentType: A string containing the type of content. Either "text/html" or "text/plain". Defaults to "text/plain".
Uri: A string containing the content location of this translation.
User: A string used to track the originator of the submission.
State: User state to help correlate request and response. The same contents will be returned in the response.

Sequence

Category optional xs:string

A string containing the category (domain) of the translation. Defaults to "general".

ContentType optional xs:string

A string containing the type of content. Either "text/html" or "text/plain". Defaults to "text/plain".

GenderFrom optional xs:string

GenderTo optional xs:string

IncludeMultipleMTAlternatives optional xs:boolean

ProfanityAction optional xs:string

ReservedFlags optional xs:string

State optional xs:string

User state to help correlate request and response. The same contents will be returned in the response.

Uri optional xs:string

A string containing the content location of this translation.

User optional xs:string

A string used to track the originator of the submission.

Source

<xs:element name="GetTranslations" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexType>
    <xs:sequence>
      <xs:element minOccurs="0" name="appId" nillable="true" type="xs:string" />
      <xs:element minOccurs="0" name="text" nillable="true" type="xs:string" />
      <xs:element minOccurs="0" name="from" nillable="true" type="xs:string" />
      <xs:element minOccurs="0" name="to" nillable="true" type="xs:string" />
      <xs:element minOccurs="0" name="maxTranslations" type="xs:int" />
      <xs:element minOccurs="0" name="options" nillable="true" type="q8:TranslateOptions" xmlns:q8="http://schemas.datacontract.org/2004/07/Microsoft.MT.Web.Service.V2" />
    </xs:sequence>
  </xs:complexType>
</xs:element>