Microsoft Translator V3 (förhandsversion)

Med Microsoft Azure Cognitive Services Translator kan du översätta text och dokument över 100 språk med hjälp av allmänna eller anpassade modeller.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Tjänster	Class	Regioner
Copilot Studio	Norm	Alla Power Automate-regioner utom följande:      - Amerikanska myndigheter (GCC)      - Amerikanska myndigheter (GCC High)      – China Cloud drivs av 21Vianet      - US Department of Defense (DoD)
Logiska appar	Norm	Alla Logic Apps-regioner utom följande:      – Azure Government-regioner      – Regioner i Azure Kina      - US Department of Defense (DoD)
Power Apps	Norm	Alla Power Apps-regioner utom följande:      - Amerikanska myndigheter (GCC)      - Amerikanska myndigheter (GCC High)      – China Cloud drivs av 21Vianet      - US Department of Defense (DoD)
Power Automate	Norm	Alla Power Automate-regioner utom följande:      - Amerikanska myndigheter (GCC)      - Amerikanska myndigheter (GCC High)      – China Cloud drivs av 21Vianet      - US Department of Defense (DoD)

Kontakt
Namn	Microsoft Translator
URL	https://learn.microsoft.com/azure/cognitive-services/translator/translator-overview
E-postmeddelande	mtfb@microsoft.com

Metadata för anslutningsprogram
Utgivare	Microsoft Translator
Webbplats	https://learn.microsoft.com/azure/cognitive-services/translator/translator-overview
Sekretesspolicy	https://privacy.microsoft.com/
Kategorier	Artificiell intelligens; Business Intelligence

Med Azure Cognitive Services Translator-anslutningsappen kan du integrera alla komponenter i Power Platform, till exempel Power Automate Flow eller Power App med vår Microsoft Translator-tjänst. Med den här anslutningsappen kan du utföra följande åtgärder:

• Översätta text.

• Transkribera text.

• Översätt en mängd olika dokumentfiltyper.

Förutsättningar

Följ anvisningarna för att skapa en Translator-resurs på Azure-portalen

Hämta autentiseringsuppgifter

• När du har skapat en Translator-resurs hämtar du resursnamnet och nyckeln från Azure-portalen.

• Följ dessa förutsättningar för översättning av dokument.

• Navigera i käll- och målcontainrarna och klicka på "Växla till Microsoft Entra-ID-användarkonto" enligt skärmbilden nedan. Det här steget krävs endast för anslutningsappen.

Kom igång med anslutningsappen

Följ de här anvisningarna om hur du använder Translator Connector i ett flöde och automatiserar dina översättningsuppgifter.

Vanliga fel

I den här dokumentationen finns vanliga fel – https://learn.microsoft.com/en-us/azure/cognitive-services/translator/reference/v3-0-reference#errors

Skapa en anslutning

Anslutningsappen stöder följande autentiseringstyper:

Åtkomstnyckel	Ange ditt Microsoft Translator-resursnamn och Azure Cognitive Services-resursnyckel för Translator.	Alla regioner	Shareable
Hanterad identitet för Logic Apps	Skapa en anslutning med hjälp av en LogicApps-hanterad identitet	ENDAST LOGICAPPS	Shareable
Standard [INAKTUELL]	Det här alternativet är endast för äldre anslutningar utan en explicit autentiseringstyp och tillhandahålls endast för bakåtkompatibilitet.	Alla regioner	Går inte att dela

Åtkomstnyckel

Autentiserings-ID: keyBasedAuth

Tillämpligt: Alla regioner

Ange ditt Microsoft Translator-resursnamn och Azure Cognitive Services-resursnyckel för Translator.

Det här är en delningsbar anslutning. Om power-appen delas med en annan användare delas även anslutningen. Mer information finns i Översikt över anslutningsappar för arbetsyteappar – Power Apps | Microsoft Docs

Namn	Typ	Description	Krävs
Translator-resursnamn	snöre	Ange resursnamnet för Microsoft Translator	Sann
Resursnyckel	securestring	Azure Cognitive Services-resursnyckel för Translator.	Sann

Hanterad identitet för Logic Apps

Autentiserings-ID: managedIdentityAuth

Tillämpligt: ENDAST LOGICAPPS

Skapa en anslutning med hjälp av en LogicApps-hanterad identitet

Det här är en delningsbar anslutning. Om power-appen delas med en annan användare delas även anslutningen. Mer information finns i Översikt över anslutningsappar för arbetsyteappar – Power Apps | Microsoft Docs

Namn	Typ	Description	Krävs
LogicApps Hanterad identitet	managedIdentity	Logga in med en hanterad identitet för Logic Apps	Sann
Translator-resursnamn	snöre	Ange resursnamnet för Microsoft Translator	Sann
Resursnyckel	securestring	Azure Cognitive Services-resursnyckel för Translator.	Sann

Standard [INAKTUELL]

Tillämpligt: Alla regioner

Det här alternativet är endast för äldre anslutningar utan en explicit autentiseringstyp och tillhandahålls endast för bakåtkompatibilitet.

Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.

Namn	Typ	Description	Krävs
Translator-resursnamn	snöre	Ange resursnamnet för Microsoft Translator	Sann
Resursnyckel	securestring	Azure Cognitive Services-resursnyckel för Translator.	Sann

Begränsningsgränser

Name	Anrop	Förnyelseperiod
API-anrop per anslutning	100	60 sekunder

Åtgärder

Avbryt översättning	Avbryter ett dokumentöversättningsjobb som för närvarande bearbetas eller placeras i kö.
Få dokumentformat som stöds	Hämtar en lista över dokumentformat som stöds.
Hämta dokumentstatus	Hämtar status för ett visst dokument i ett jobb.
Hämta dokumentstatus	Hämtar status för alla dokument i ett översättningsjobb.
Hämta lagringskällor som stöds	Hämtar en lista över lagringskällor/alternativ som stöds.
Hämta ordlisteformat som stöds	Hämtar en lista över ordlisteformat som stöds.
Hämta språk	Hämtar alla språk som stöds för översättning av Microsoft Azure Cognitive Services Translator.
Hämta översättningsstatus	Hämtar en sammanfattning av statusen för en specifik dokumentöversättningsbegäran.
Hämta översättningsstatus	Hämtar en lista tillsammans med statusen för alla översättningsbegäranden som skickas av användaren.
Starta dokumentöversättning	Den här åtgärden startar ett dokumentöversättningsjobb.
Transliterate	Konverterar text på ett språk från ett skript till ett annat skript.
Översätta text	Översätt angiven källspråktext till målspråktexten.

Avbryt översättning

Åtgärds-ID:

CancelTranslation

Avbryter ett dokumentöversättningsjobb som för närvarande bearbetas eller placeras i kö.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Åtgärds-ID	id	True	string	Åtgärds-ID:t.

Returer

Body

TranslationStatusResponse

Få dokumentformat som stöds

Åtgärds-ID:

GetSupportedDocumentFormats

Hämtar en lista över dokumentformat som stöds.

Returer

Body

FormatOKResponse

Hämta dokumentstatus

Åtgärds-ID:

GetDocumentStatus

Hämtar status för ett visst dokument i ett jobb.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Åtgärds-ID	id	True	string	Åtgärds-ID:t.
Dokument-ID	documentId	True	string	Dokument-ID:t.

Returer

Body

DocumentStatusResponse

Hämta dokumentstatus

Åtgärds-ID:

GetDocumentsStatus

Hämtar status för alla dokument i ett översättningsjobb.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Åtgärds-ID	id	True	string	Åtgärds-ID:t.
Totalt antal poster som ska returneras	$top		integer	Det totala antalet poster som användaren vill ska returneras på alla sidor.
Antal poster att hoppa över	$skip		integer	Antalet poster som ska hoppa från listan baserat på sorteringsmetoden.
Maximalt antal poster som returneras	$maxpagesize		integer	Maximalt antal poster som returneras på en sida.
Sortera efter	$orderBy		array	Sorteringsfrågan för samlingen. (t.ex. "CreatedDateTimeUtc asc", "CreatedDateTimeUtc desc").
Startdatumtid	createdDateTimeUtcStart		date-time	Startdatumtid för att hämta objekt efter.
Slutdatum	createdDateTimeUtcEnd		date-time	Slutdatumet för att hämta objekt innan.
Filtrera efter status	statuses		array	Statusar som ska användas vid filtrering.
Filtrera efter dokument-ID	ids		array	Dokument-ID:t som ska användas vid filtrering.

Returer

Name	Sökväg	Typ	Description
värde	value	array of object	Svarsvärde.
path	value.path	string	Plats för dokumentet eller mappen.
sourcePath (källa)	value.sourcePath	string	Källdokumentets plats.
createdDateTimeUtc	value.createdDateTimeUtc	string	Åtgärden skapade datumtid.
lastActionDateTimeUtc	value.lastActionDateTimeUtc	string	Datum då åtgärdens status har uppdaterats.
status	value.status	string	Lista över möjliga statusar för jobb eller dokument.
till	value.to	string	Målspråk.
Förlopp	value.progress	integer	Översättningens förlopp om det är tillgängligt.
Id-nummer	value.id	string	Dokument-ID.
characterCharged	value.characterCharged	integer	Tecken som debiteras av API:et.
@nextLink	@nextLink	string	Url till nästa sida. Null om sista sidan.

Hämta lagringskällor som stöds

Åtgärds-ID:

GetSupportedStorageSources

Hämtar en lista över lagringskällor/alternativ som stöds.

Returer

Name	Sökväg	Typ	Description
värde	value	array of string	Svarsvärde.

Hämta ordlisteformat som stöds

Åtgärds-ID:

GetSupportedGlossaryFormats

Hämtar en lista över ordlisteformat som stöds.

Returer

Body

FormatOKResponse

Hämta språk

Åtgärds-ID:

GetTranslateSupportedLanguages

Hämtar alla språk som stöds för översättning av Microsoft Azure Cognitive Services Translator.

Returer

response

array of Language

Hämta översättningsstatus

Åtgärds-ID:

GetTranslationStatus

Hämtar en sammanfattning av statusen för en specifik dokumentöversättningsbegäran.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Åtgärds-ID	id	True	string	Åtgärds-ID:t.

Returer

Body

TranslationStatusResponse

Hämta översättningsstatus

Åtgärds-ID:

GetTranslationsStatus

Hämtar en lista tillsammans med statusen för alla översättningsbegäranden som skickas av användaren.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Totalt antal poster som ska returneras	$top		integer	Det totala antalet poster som användaren vill ska returneras på alla sidor.
Antal poster att hoppa över	$skip		integer	Antalet poster som ska hoppa från listan baserat på sorteringsmetoden.
Maximalt antal poster som returneras	$maxpagesize		integer	Maximalt antal poster som returneras på en sida.
Sortera efter	$orderBy		array	Sorteringsfrågan för samlingen, t.ex. "CreatedDateTimeUtc asc", "CreatedDateTimeUtc desc".
Startdatumtid	createdDateTimeUtcStart		date-time	Startdatumtiden för att hämta poster efter.
Slutdatum	createdDateTimeUtcEnd		date-time	Slutdatumet för att hämta poster innan.
Filtrera efter status	statuses		array	Statusar som ska användas vid filtrering.
Filtrera efter åtgärds-ID:t	ids		array	Åtgärds-ID:t som ska användas vid filtrering.

Returer

Name	Sökväg	Typ	Description
värde	value	array of TranslationStatusResponse	Svarsvärde.
@nextLink	@nextLink	string	Url till nästa sida. Null om sista sidan.

Starta dokumentöversättning

Åtgärds-ID:

StartDocumentTranslation

Den här åtgärden startar ett dokumentöversättningsjobb.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Lagringstyp för indatadokumenten	storageType	True	string	Välj en fil eller mapp.
Källspråk	sourceLanguage	True	string	Språkkod. Om inget anges försöker Microsoft Translator identifiera dokumentspråket automatiskt.
Källdokumentens plats	sourceURL	True	string	Platsen för källdokumenten som kan vara en enda fil eller en mapp. Den här platsen är en URL-länk från Azure Blob Storage.
Prefixfilter	documentFilterPrefix		string	En skiftlägeskänslig prefixsträng för att filtrera dokument i källsökvägen för översättning. När du till exempel använder en Azure Storage Blob-URI använder du prefixet för att begränsa undermappar för översättning.
Suffixfilter	documentFilterSuffix		string	En skiftlägeskänslig suffixsträng för att filtrera dokument i källsökvägen för översättning. Det används oftast för filnamnstillägg.
Kategori	targetCategory		string	En sträng som anger översättningens kategori (domän). Den här parametern används för att hämta översättningar från ett anpassat system som skapats med Custom Translator.
Platsen för de översatta dokumenten	targetContainerURL	True	string	Platsen där de översatta dokumenten lagras. Den här platsen är en URL-länk från Azure Blob Storage.
Målspråk	targetLanguage	True	string	Målspråkkod.
Ordliste-URL	glossaryUrl		string	Platsen för ordlistedokumenten. Den här platsen är en URL-länk från Azure Blob Storage.
Ordlistedokumentformat och -version	glossaryFormatVersion		string	Ordlistedokumentformat och -version.

Returer

Name	Sökväg	Typ	Description
operationID	operationID	string	Åtgärds-ID.

Transliterate

Åtgärds-ID:

Transliterate

Konverterar text på ett språk från ett skript till ett annat skript.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Language	language	True	string	Anger språket för texten som ska konverteras från ett skript till ett annat.
Källskript	fromScript	True	string	Namnet på skriptet för indatatexten.
Målskript	toScript	True	string	Namnet på skriptet för den translitererade texten.
Text	Text	True	string	Text att översätta.

Returer

response

array of TransliterationResults

Översätta text

Åtgärds-ID:

Translate

Översätt angiven källspråktext till målspråktexten.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Källspråk	from	True	string	Källkoden (exempel: 'en'). Om källkoden inte har angetts tillämpas automatisk språkidentifiering för att fastställa källspråket.
Målspråk	to	True	string	Målspråkkoden (exempel: 'fr').
Texttyp	textType		string	Definierar om textformatet som översätts är oformaterad text eller HTML.
Svordomsåtgärd	profanityAction		string	Anger hur svordomar ska behandlas i översättningar.
Markör för svordomar	profanityMarker		string	Anger hur svordomar ska markeras i översättningar.
Inkludera meningslängd	includeSentenceLength		string	Anger om meningsgränser ska inkluderas för indatatexten och den översatta texten.
Föreslaget källspråk	suggestedFrom		string	Anger ett reservspråk om språket i indatatexten inte kan identifieras.
Skript för källtexten	fromScript		string	Namnet på skriptet för indatatexten.
Skript för den översatta texten	toScript		string	Namnet på skriptet för den översatta texten.
Kategori	category		string	En sträng som anger översättningens kategori (domän). Den här parametern används för att hämta översättningar från ett anpassat system som skapats med Custom Translator.
Tillåt återställning till allmän domän	allowFallback		string	Anger att tjänsten tillåts återgå till ett allmänt system när det inte finns något anpassat system.
Text	Text	True	string	Text att översätta.

Returer

response

array of TranslationResults

Definitioner

TranslationResults

Översättningsresultat.

Name	Sökväg	Typ	Description
Översatt text	TranslatedText	string	Hämtar den översatta texten.
Transkriberad text	TransliteratedText	string	Hämtar den translitererade texten.

TransliterationResults

Transkriberingsresultat.

Name	Sökväg	Typ	Description
Text	text	string	Hämtar den translitererade texten.
Script	script	string	Translitererat skript.

Language

Språkkod. Om inget anges försöker Microsoft Translator identifiera dokumentspråket automatiskt.

Name	Sökväg	Typ	Description
Språkkod	Code	string	Hämtar eller anger språkkoden.
Language	Name	string	Hämtar eller anger språket.

FormatOKResponse

Name	Sökväg	Typ	Description
värde	value	array of object	Filformat med information.
format	value.format	string	Namn på dokumentformatet.
fileExtensions	value.fileExtensions	array of string	Filnamnstillägg som stöds för det här formatet.
contentTypes	value.contentTypes	array of string	Innehållstyper som stöds för det här formatet.
versions	value.versions	array of string	Version som stöds.
defaultVersion (standardversion)	value.defaultVersion	string	Standardversion om ingen har angetts.

TranslationStatusResponse

Name	Sökväg	Typ	Description
Id-nummer	id	string	ID för åtgärden.
createdDateTimeUtc	createdDateTimeUtc	string	Åtgärden skapade datumtid.
lastActionDateTimeUtc	lastActionDateTimeUtc	string	Datum då åtgärdens status har uppdaterats.
status	status	string	Lista över möjliga statusar för jobb eller dokument som Canceled, Cancelling, Failed, NotStarted, Running, Succeeded, ValidationFailed.
summa	summary.total	integer	Antal dokument totalt.
Misslyckades	summary.failed	integer	Antalet dokument misslyckades.
framgång	summary.success	integer	Antal dokument som har översatts.
inProgress	summary.inProgress	integer	Antal dokument som pågår.
notYetStarted	summary.notYetStarted	integer	Antalet dokument som ännu inte har börjat bearbetas.
cancelled	summary.cancelled	integer	Antal dokument som har avbrutits.
totalCharacterCharged	summary.totalCharacterCharged	integer	Totalt antal tecken som debiteras.

DocumentStatusResponse

Name	Sökväg	Typ	Description
path	path	string	Plats för dokumentet eller mappen.
sourcePath (källa)	sourcePath	string	Källdokumentets plats.
createdDateTimeUtc	createdDateTimeUtc	string	Åtgärden skapade datumtid.
lastActionDateTimeUtc	lastActionDateTimeUtc	string	Datum då åtgärdens status har uppdaterats.
status	status	string	Lista över möjliga statusar för jobb eller dokument som Canceled, Cancelling, Failed, NotStarted, Running, Succeeded, ValidationFailed.
till	to	string	Målspråk.
Förlopp	progress	integer	Översättningens förlopp om det är tillgängligt.
Id-nummer	id	string	Dokument-ID.
characterCharged	characterCharged	integer	Tecken som debiteras av API:et.