Translation Services

To add configuration information for Google or Microsoft machine language translation services for a portal, a system administrator must provide the configuration.

After a system administrator has configured the machine language translation service for a portal, a system or portal administrator must configure the Google or Microsoft services for the case on the Portal Management > Cases and Servers > Case Options page for a case. For more information, see Translate with Google or Translate with Microsoft in the Case Options topic.

Note: Although the United Language Group option appears on this page, this service is not yet available.

Important: On-premises clients must have their own Google or Microsoft translation services. For information about the Microsoft translation service, see https://docs.microsoft.com/en-us/azure/cognitive-services/Translator/translator-text-how-to-signup. For information about the Google translation service, see https://cloud.google.com/translate.

To add configuration information for Google or Microsoft:

On the Portal Management > Settings > Translation Services page, to set the configuration value, write the JSON object syntax and include the key/value pairs described in the following tables for Google, for Microsoft, or both translation services. Examples are provided after the tables.

Google API

Key	Value
ConcurrentCalls	The number of concurrent calls made from an RPF worker process or web server.
DelayBetweenBatchesInMs	The delay between each batch of concurrent calls. For example, if set to 1000, after making 10 concurrent calls the code will wait for 1000 milliseconds before making another 10 concurrent calls.
CharacterLimits	The maximum number of characters sent in each call.
Key	Your API key for the Google Cloud Translation API.
URL	The Google Cloud Translation API endpoint URL.
TimeoutInSeconds	The number of seconds the code will wait for a response.

For example, for Google, the JSON string looks similar to the following:

{"ConcurrentCalls":10,"DelayBetweenBatchesInMs":0,"CharacterLimits":10000,"Key":"******","Url":"https://translation.googleapis.com/language/translate/v2","TimeoutInSeconds":10}

Note: After saving the configuration, the key value is replaced with *** in the display of the configuration string. Therefore, when modifying the configuration strings, the entire string, including your API key value, needs to be repopulated and saved.

Microsoft API

Key	Value
ConcurrentCalls	The number of concurrent calls made from an RPF worker process or web server.
DelayBetweenBatchesInMs	The delay between each batch of concurrent calls. For example, if set to 1000, after making 10 concurrent calls the code will wait for 1000 milliseconds before making another 10 concurrent calls.
CharacterLimits	The maximum number of characters sent in each call.
Key	Your API key for the Microsoft Translator API.
URL	The Microsoft Translator API endpoint URL.
TimeoutInSeconds	The number of seconds the code will wait for a response.

For example, for Microsoft, the JSON string looks similar to the following:

{"ConcurrentCalls":4,"DelayBetweenBatchesInMs":1800,"CharacterLimits":4999,"Key":"******","Url":"https://api-nam.cognitive.microsofttranslator.com/translate?api-version=3.0","TimeoutInSeconds":30}