Connectors Reference

Microsoft Translator

Microsoft Translator lets you translate text across multiple languages.

 

Status: Preview

Tier: Standard

Version: 1.0

 

Actions:

Name

Summary

Languages ()

Get languages

Translate (string query, string languageTo, [advanced][Optional]string languageFrom, [advanced][Optional]string category, [advanced][Optional]string contentType)

Translate text

Detect (string query)

Detect language

SpeechLanguages ()

Get speech languages

TextToSpeech (string query, string language, [advanced][Optional]string format, [advanced][Optional]string options)

Text to speech

 

Triggers:

Name

Summary

 

Objects:

Name

Summary

Language

 

 

Actions:

Languages

Summary: Get languages

Description: Retrieves all languages that Microsoft Translator supports.

 

Syntax:

MicrosoftTranslator.Languages ()

 

Returns:

          Type:array of (Language)

 

Translate

Summary: Translate text

Description: Translates text to a specified language using Microsoft Translator.

 

Syntax:

MicrosoftTranslator.Translate (string query, string languageTo, [advanced][Optional]string languageFrom, [advanced][Optional]string category, [advanced][Optional]string contentType)

 

Parameters:

Name

Type

Summary

Required

Related Action

query

string

(Text)

The text to translate.

True

languageTo

string

(Target Language)

The target language code (example: 'fr').

True

Languages

languageFrom

string

(Source Language)

The source language (if not provided, Microsoft Translator will try to auto-detect) (example: en).

False

Languages

category

string

(Category)

The translation category (default: 'general').

False

contentType

string

(Content Type)Values: [text/plain, text/html]

The content type (default: 'text/plain').

False

 

Returns:

          Type:string

          Summary: Translated Text

 

Detect

Summary: Detect language

Description: Detects the source language of the given text.

 

Syntax:

MicrosoftTranslator.Detect (string query)

 

Parameters:

Name

Type

Summary

Required

Related Action

query

string

(Text)

The text to translate.

True

 

Returns:

          Type:Language

          Description: Language Model for Microsoft Translator translatable languages

 

SpeechLanguages

Summary: Get speech languages

Description: Retrieves the languages available for speech synthesis.

 

Syntax:

MicrosoftTranslator.SpeechLanguages ()

 

Returns:

          Type:array of (Language)

 

TextToSpeech

Summary: Text to speech

Description: Converts a given text into speech as an audio stream in wave format.

 

Syntax:

MicrosoftTranslator.TextToSpeech (string query, string language, [advanced][Optional]string format, [advanced][Optional]string options)

 

Parameters:

Name

Type

Summary

Required

Related Action

query

string

(Text)

The text to translate.

True

language

string

(Language Code)

Language code to generate speech (example: 'en-us').

True

SpeechLanguages

format

string

(Format)Values: [audio/wav, audio/mp3]

The audio format to return (default is audio/wav).

False

options

string

(Options)Values: [MinSize, MaxQuality]

Other options for the format (default is MinSize). Valid options are 'MinSize' or 'MaxQuality'.

False

 

Returns:

          Type:string(binary)

          Summary: Audio File

 


 

Language

Summary:

Description: Language Model for Microsoft Translator translatable languages

 

          Properties:

Name

Type

Summary

Code

string

Language Code

Gets or sets the language code.

Name

string

Language Name

Gets or sets the language name.