Compartilhar via


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

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

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'.