TranslateArray Method

Use the TranslateArray method to retrieve translations for multiple source texts.

TranslateArrayResponse[] Microsoft.Translator.TranslateArray(appId, texts, from, to, options);

Parameter Description


Required. If the Authorization header is used, leave the appid field empty else specify a string containing "Bearer" + " " + access token.


Required. An array containing the texts for translation. All strings must be of the same language. The total of all texts to be translated must not exceed 10000 characters. The maximum number of array elements is 2000.


Optional. A string representing the language code to translate the text from. If left empty the response will include the result of language auto-detection.


Required. A string representing the language code to translate the text to.


Optional. A TranslateOptions element containing the values 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 : The format of the text being translated. The supported formats are "text/plain", "text/xml" and "text/html". Any HTML needs to be well-formed.
  • Uri : Filter results by this URI. Default: all
  • User : Filter results by this user. Default: all
  • State : User state to help correlate request and response. The same contents will be returned in the response.
  • ProfanityAction : If you want to avoid getting profanity in the translation, regardless of the presence of profanity in the source text, you can use the new profanity filtering option. The new option allows you to choose whether you want to see profanity deleted or marked with appropriate tags, or no action taken. The accepted values of ProfanityAction are “NoAction”, “Marked” and “Deleted”.

Request Headers

The following table describes required and optional request headers.

Request Header Description


Required. Specify the the value of access_token in format "Bearer" + " " + Access Token Value

Return value
Returns a TranslateArrayResponse array. Each TranslateArrayResponse has the following elements:
  • Error : Indicates an error if one has occurred. Otherwise set to null.
  • OriginalSentenceLengths : An array of integers indicating the length of each sentence in the original source text. The length of the array indicates the number of sentences.
  • TranslatedText : The translated text.
  • TranslatedSentenceLengths : An array of integers indicating the length of each sentence in the translated text. The length of the array indicates the number of sentences.
  • State : User state to help correlate request and response. Returns the same content as in the request.

Ff512438.alert_note(en-us,MSDN.10).gif Note

Bing App ID is deprecated and is no longer supported.   Please obtain an access token to use the Microsoft Translator API. For details, go here.



using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Net;
using System.IO;
using System.Runtime.Serialization.Json;
using System.Runtime.Serialization;
using System.Web;
using System.ServiceModel.Channels;
using System.ServiceModel;
namespace MicrosoftTranslatorSdk.SoapSamples
    class Program
        static void Main(string[] args)
            AdmAccessToken admToken;
            string headerValue;
            //Get Client Id and Client Secret from
            //Refer obtaining AccessToken ( 
            AdmAuthentication admAuth = new AdmAuthentication("clientId", "client secret");
                admToken = admAuth.GetAccessToken();
                DateTime tokenReceived = DateTime.Now;
                // Create a header with the access_token property of the returned token
                headerValue = "Bearer " + admToken.access_token;
            catch (Exception ex)
                Console.WriteLine("Press any key to continue...");
        private static void TranslateArrayMethod(string authToken)
            // Add TranslatorService as a service reference, Address:
            TranslatorService.LanguageServiceClient client = new TranslatorService.LanguageServiceClient();
            //Set Authorization header before sending the request
            HttpRequestMessageProperty httpRequestProperty = new HttpRequestMessageProperty();
            httpRequestProperty.Method = "POST";
            httpRequestProperty.Headers.Add("Authorization", authToken);

            // Creates a block within which an OperationContext object is in scope.
            using (OperationContextScope scope = new OperationContextScope(client.InnerChannel))
                OperationContext.Current.OutgoingMessageProperties[HttpRequestMessageProperty.Name] = httpRequestProperty;
                string[] translateArraySourceTexts = { "The answer lies in machine translation.", "the best machine translation technology cannot always provide translations tailored to a site or users like a human ", "Simply copy and paste a code snippet anywhere " };
                MicrosoftTranslatorSdk.SoapSamples.TranslatorService.TranslateOptions translateArrayOptions = new MicrosoftTranslatorSdk.SoapSamples.TranslatorService.TranslateOptions(); // Use the default options
                //Keep appId parameter blank as we are sending access token in authorization header.
                MicrosoftTranslatorSdk.SoapSamples.TranslatorService.TranslateArrayResponse[] translatedTexts = client.TranslateArray("", translateArraySourceTexts, "en", "fr", translateArrayOptions);

                Console.WriteLine("The translated texts from en to fr are: ");
                for (int i = 0; i < translatedTexts.Length; i++)
                    Console.WriteLine("Source text:{0}{1}Translated Text:{2}{3}", translateArraySourceTexts[i], Environment.NewLine, translatedTexts[i].TranslatedText, Environment.NewLine);

                Console.WriteLine("Press any key to continue...");


Goto Top


class AccessTokenAuthentication {
     * Get the access token.
     * @param string $grantType    Grant type.
     * @param string $scopeUrl     Application Scope URL.
     * @param string $clientID     Application client ID.
     * @param string $clientSecret Application client ID.
     * @param string $authUrl      Oauth Url.
     * @return string.
    function getTokens($grantType, $scopeUrl, $clientID, $clientSecret, $authUrl){
        try {
            //Initialize the Curl Session.
            $ch = curl_init();
            //Create the request Array.
            $paramArr = array (
             'grant_type'    => $grantType,
             'scope'         => $scopeUrl,
             'client_id'     => $clientID,
             'client_secret' => $clientSecret
            //Create an Http Query.//
            $paramArr = http_build_query($paramArr);
            //Set the Curl URL.
            curl_setopt($ch, CURLOPT_URL, $authUrl);
            //Set HTTP POST Request.
            curl_setopt($ch, CURLOPT_POST, TRUE);
            //Set data to POST in HTTP "POST" Operation.
            curl_setopt($ch, CURLOPT_POSTFIELDS, $paramArr);
            //CURLOPT_RETURNTRANSFER- TRUE to return the transfer as a string of the return value of curl_exec().
            curl_setopt ($ch, CURLOPT_RETURNTRANSFER, TRUE);
            //CURLOPT_SSL_VERIFYPEER- Set FALSE to stop cURL from verifying the peer's certificate.
            curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
            //Execute the  cURL session.
            $strResponse = curl_exec($ch);
            //Get the Error Code returned by Curl.
            $curlErrno = curl_errno($ch);
                $curlError = curl_error($ch);
                throw new Exception($curlError);
            //Close the Curl Session.
            //Decode the returned JSON string.
            $objResponse = json_decode($strResponse);
            if ($objResponse->error){
                throw new Exception($objResponse->error_description);
            return $objResponse->access_token;
        } catch (Exception $e) {
            echo "Exception-".$e->getMessage();

 * Class:AccessTokenAuthentication
 * Create SOAP Object.
class SOAPMicrosoftTranslator {
     * Soap Object.
     * @var ObjectArray.
    public $objSoap;
     * Create the SAOP object.
     * @param string $accessToken Access Token string.
     * @param string $wsdlUrl     WSDL string.
     * @return string.
    public function __construct($accessToken, $wsdlUrl){
        try {
            //Authorization header string.
            $authHeader = "Authorization: Bearer ". $accessToken;
            $contextArr = array(
                'http'   => array(
                    'header' => $authHeader
            //Create a streams context.
            $objContext = stream_context_create($contextArr);
            $optionsArr = array (
                'soap_version'   => 'SOAP_1_2',
                'encoding'          => 'UTF-8',
                'exceptions'      => true,
                'trace'          => true,
                'cache_wsdl'     => 'WSDL_CACHE_NONE',
                'stream_context' => $objContext,
                'user_agent'     => 'PHP-SOAP/'.PHP_VERSION."\r\n".$authHeader    
            //Call Soap Client.
            $this->objSoap = new SoapClient($wsdlUrl, $optionsArr);
        } catch(Exception $e){
            echo "<h2>Exception Error!</h2>";
            echo $e->getMessage();

try {
    //Soap WSDL Url
    $wsdlUrl       = "";
    //Client ID of the application.
    $clientID       = "clientId";
    //Client Secret key of the application.
    $clientSecret = "clientSecret";
    //OAuth Url.
    $authUrl      = "";
    //Application Scope Url
    $scopeUrl     = "";
    //Application grant type
    $grantType    = "client_credentials";

    //Create the Authentication object
    $authObj      = new AccessTokenAuthentication();
    //Get the Access token
    $accessToken  = $authObj->getTokens($grantType, $scopeUrl, $clientID, $clientSecret, $authUrl);
    //Create soap translator Object
    $soapTranslator = new SOAPMicrosoftTranslator($accessToken, $wsdlUrl);
    //Set the params.
    $fromLanguage = "en";
    $toLanguage   = "de";
    $inputStrArr     = array("The answer lies in machine translation", "the best machine translation technology cannot always provide translations tailored to a site or users like a human", "Simply copy and paste a code snippet anywhere");
    //Optional argument list.
    $optionArg = array (
        'category'    => "general", 
        'ContentType' => "text/plain",
        'Uri'         => 'all', 
        'User'        => 'all' 
    //Request argument list.
    $requestArg = array (
         'texts'   => $inputStrArr,
         'from'    => $fromLanguage,
         'to'      => $toLanguage,
         'options' => $optionArg    
    echo "<table border=2px>";
    echo "<tr>";
    echo "<td><b>From $fromLanguage</b></td><td><b>To $toLanguage</b></td>";
    echo "</tr>";
    $response = $soapTranslator->objSoap->TranslateArray($requestArg);
    foreach( $response->TranslateArrayResult->TranslateArrayResponse as $translatedRes) {
        $translatedText = $translatedRes->TranslatedText." ";
        echo "<tr><td>".$inputStrArr[$i]."</td><td>". $translatedText."</td></tr>";
    echo "</table>";
} catch (Exception $e) {
    echo "Exception: " . $e->getMessage() . "<br/>";
Goto Top