AddTranslationArray Method

Adds an array of translations to add translation memory. This is an array version of AddTranslation().

Microsoft.Translator.AddTranslationArray(appId, translations, 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 of translations to add to translation memory. Each translation must contain: originalText, translatedText, rating. The size of each originalText and translatedText is limited to 1000 chars. The total of all the originalText(s) and translatedText(s) must not exceed 10000 characters. The maximum number of array elements is 100.


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


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


A set of options. TranslateOptions contain: uri , category , contentType , user .

User is required. Category , ContentType and Uri are optional.

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

Ff512425.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 AddTranslationArrayMethod(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;
                    MicrosoftTranslatorSdk.SoapSamples.TranslatorService.Translation translation1 = new MicrosoftTranslatorSdk.SoapSamples.TranslatorService.Translation();
                    translation1.OriginalText = "una importante contribución a la rentabilidad de la empresa";
                    translation1.TranslatedText = "a significant contribution tothe company profitability";
                    translation1.Rating = 1;

                    MicrosoftTranslatorSdk.SoapSamples.TranslatorService.Translation translation2 = new MicrosoftTranslatorSdk.SoapSamples.TranslatorService.Translation();
                    translation2.OriginalText = "a veces los errores son divertidos";
                    translation2.TranslatedText = "in some cases errors are fun";
                    translation2.Rating = 1;
                    //Keep appId parameter blank as we are sending access token in authorization header.
                    MicrosoftTranslatorSdk.SoapSamples.TranslatorService.Translation[] translationsAdd = { translation1, translation2 };

                    MicrosoftTranslatorSdk.SoapSamples.TranslatorService.TranslateOptions translateOptionsAdd = new MicrosoftTranslatorSdk.SoapSamples.TranslatorService.TranslateOptions();
                    translateOptionsAdd.Category = "general";
                    translateOptionsAdd.ContentType = "text/plain";
                    translateOptionsAdd.User = "TestUserID";

                    client.AddTranslationArray("", translationsAdd, "es", "en", translateOptionsAdd);

                    Console.WriteLine(string.Format("Your translations for '{0}' and '{1}' has been added", translation1.OriginalText, translation2.OriginalText));
                catch (Exception ex)

                    Console.WriteLine("An error occurred while adding translation. Detailed Error:{0}", ex.Message);
                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 the soap translator Object
    $soapTranslator = new SOAPMicrosoftTranslator($accessToken, $wsdlUrl);

    //Set the params
    $fromLanguage = "de";
    $toLanguage   = "en";

    //Create the translation Array.
    $translationArr   = array();
    $translationArr[] = array(
        'OriginalText'   => 'Techniker arbeiten, um das Problem zu beheben',
        'TranslatedText' => 'engineers are currently working to fix this problem',
         'Rating'         => 10 

    $translationArr[] = array (
        'OriginalText'   => 'Wir versuchen, offensiven Wortschatz bzw.',
        'TranslatedText' => 'we are trying to filter out inappropriate language',
         'Rating'         => 10 

    //Option Argument array.
    $optionsArg =array (
         'ContentType' => 'text/plain',
         'Category'    => 'general',
         'User'        => 'TestUser',
         'Uri'         => null

    //Request argument list.
    $requestArg = array (
         'translations' => $translationArr,
         'from'         => $fromLanguage,
         'to'             => $toLanguage,
         'options'         => $optionsArg

    foreach ($translationArr as $translation)
    echo "Translation for '".$translation["OriginalText"]."' added successfully."."<br/>";

} catch (Exception $e) {
    echo "Exception: " . $e->getMessage() . "<br/>";
Goto Top