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 |
|---|---|---|
| Copilot Studio | Standard | All Power Automate regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure China regions - 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) |
| Power Automate | Standard | All Power Automate 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
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
Retrieves all languages that Microsoft Translator supports for translation, transliteration or dictionary scopes
Returns
- response
- array of Language
Translate text
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'.