Microsoft Translator V2

Microsoft Translator lets you translate text across multiple languages.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following:      -   Azure China regions      -   US Department of Defense (DoD)
Power Automate	Standard	All Power Automate regions except the following:      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)
Power Apps	Standard	All Power Apps regions except the following:      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)

Contact
Name	Microsoft
URL	Microsoft LogicApps Support Microsoft Power Automate Support Microsoft Power Apps Support

Connector Metadata
Publisher	Microsoft
Website	https://www.microsoft.com/translator/

To create a connection, select the "Microsoft Translator V2" source and specify your subscription key for Microsoft Translator Text API into the Subscription Key field, or leave it blank to use an internal shared key.

• If no subscription key is provided, the shared API key will be used, which comes with built-in throttling limits based on the number of characters that are being translated, specifically 55,000 characters per day and 100 requests per minute.
• If you provide your own subscription key, there will be no characters limit used by the connector and the rate limit will be raised to 1000 requests per minute. In this case the Translator API will enforce limits based on your subscription (learn more here).
• Only 'Global' location subscription keys are supported.

Only 2 connections can be created per account, if you see an error creating a new connection please check your connections list for existing Microsoft Translator V2 connections.

There are couple of ways to prevent content parts from being translated - please see Translator docs for more details.

General Limits

Name	Value
Connections per account	2

Creating a connection

The connector supports the following authentication types:

Default	Parameters for creating connection.	All regions	Shareable

Default

Applicable: All regions

Parameters for creating connection.

This is shareable connection. If the power app is shared with another user, connection is shared as well. For more information, please see the Connectors overview for canvas apps - Power Apps | Microsoft Docs

Name	Type	Description	Required
Subscription Key	securestring	Specify your subscription key for Microsoft Translator Text API, or leave it blank to use an internal shared key. If empty, your API calls will be throttled based on a fixed internal limit.

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Detect language	Detects the source language of the given text.
Get languages	Retrieves all languages that Microsoft Translator supports for translation, transliteration or dictionary scopes
Translate text	Translates text to a specified language using Microsoft Translator.

Detect language

Operation ID:

Detect

Detects the source language of the given text.

Parameters

Name	Key	Required	Type	Description
Text	Text	True	string	Text to translate or detect

Returns

Language Model for Microsoft Translator translatable languages

Body

Language

Get languages

Operation ID:

Languages

Retrieves all languages that Microsoft Translator supports for translation, transliteration or dictionary scopes

Returns

response

array of Language

Translate text

Operation ID:

Translate

Translates text to a specified language using Microsoft Translator.

Parameters

Name	Key	Required	Type	Description
Target Language	to	True	string	The target language code (example: 'fr').
Source Language	from		string	The source language (if not provided, Microsoft Translator will try to auto-detect) (example: en).
Category	category		string	The translation category (default: 'general').
Text Type	textType		string	The text type (default: 'plain').
Text	Text	True	string	Text to translate or detect

Returns

Translated Text

string

Definitions

Language

Language Model for Microsoft Translator translatable languages

Name	Path	Type	Description
Language Code	Code	string	Gets or sets the language code.
Language Name	Name	string	Gets or sets the language name.

string

This is the basic data type 'string'.