TextTranslationClient.TranslateAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
TranslateAsync(String, IEnumerable<String>, String, CancellationToken)
テキストの翻訳。
public virtual System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>> TranslateAsync (string targetLanguage, System.Collections.Generic.IEnumerable<string> content, string sourceLanguage = default, System.Threading.CancellationToken cancellationToken = default);abstract member TranslateAsync : string * seq<string> * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>>
override this.TranslateAsync : string * seq<string> * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>>Public Overridable Function TranslateAsync (targetLanguage As String, content As IEnumerable(Of String), Optional sourceLanguage As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of IReadOnlyList(Of TranslatedTextItem)))パラメーター
- targetLanguage
- String
出力テキストの言語を指定します。 ターゲット言語は、翻訳スコープに含まれるサポートされている言語のいずれかである必要があります。 たとえば、to=de を使用してドイツ語に翻訳します。 クエリ文字列内でパラメーターを繰り返すことにより、同時に複数の言語に翻訳することができます。 たとえば、to=de&to=it を使用してドイツ語とイタリア語に翻訳します。
- content
- IEnumerable<String>
翻訳するテキストの配列。
- sourceLanguage
- String
入力テキストの言語を指定します。 翻訳範囲を使用してサポートされている言語を検索して、翻訳に使用できる言語を見つけます。 from パラメーターが指定されていない場合は、ソース言語を決定するために自動言語検出が適用されます。
動的ディクショナリ機能を使用する場合は、自動検出ではなく from パラメーターを使用する必要があります。 注: 動的ディクショナリ機能では、大文字と小文字が区別されます。
- cancellationToken
- CancellationToken
使用する取り消しトークン。
戻り値
例外
targetLanguage または content が null です。
適用対象
TranslateAsync(String, String, String, CancellationToken)
テキストの翻訳。
public virtual System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>> TranslateAsync (string targetLanguage, string text, string sourceLanguage = default, System.Threading.CancellationToken cancellationToken = default);abstract member TranslateAsync : string * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>>
override this.TranslateAsync : string * string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>>Public Overridable Function TranslateAsync (targetLanguage As String, text As String, Optional sourceLanguage As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of IReadOnlyList(Of TranslatedTextItem)))パラメーター
- targetLanguage
- String
出力テキストの言語を指定します。 ターゲット言語は、翻訳スコープに含まれるサポートされている言語のいずれかである必要があります。 たとえば、to=de を使用してドイツ語に翻訳します。 クエリ文字列内でパラメーターを繰り返すことにより、同時に複数の言語に翻訳することができます。 たとえば、to=de&to=it を使用してドイツ語とイタリア語に翻訳します。
- text
- String
翻訳するテキスト。
- sourceLanguage
- String
入力テキストの言語を指定します。 翻訳範囲を使用してサポートされている言語を検索して、翻訳に使用できる言語を見つけます。 from パラメーターが指定されていない場合は、ソース言語を決定するために自動言語検出が適用されます。
動的ディクショナリ機能を使用する場合は、自動検出ではなく from パラメーターを使用する必要があります。 注: 動的ディクショナリ機能では、大文字と小文字が区別されます。
- cancellationToken
- CancellationToken
使用する取り消しトークン。
戻り値
例外
targetLanguage または text が null です。
適用対象
TranslateAsync(IEnumerable<String>, IEnumerable<String>, String, String, Nullable<TextType>, String, Nullable<ProfanityAction>, Nullable<ProfanityMarker>, Nullable<Boolean>, Nullable<Boolean>, String, String, String, Nullable<Boolean>, CancellationToken)
テキストの翻訳。
public virtual System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>> TranslateAsync (System.Collections.Generic.IEnumerable<string> targetLanguages, System.Collections.Generic.IEnumerable<string> content, string clientTraceId = default, string sourceLanguage = default, Azure.AI.Translation.Text.TextType? textType = default, string category = default, Azure.AI.Translation.Text.ProfanityAction? profanityAction = default, Azure.AI.Translation.Text.ProfanityMarker? profanityMarker = default, bool? includeAlignment = default, bool? includeSentenceLength = default, string suggestedFrom = default, string fromScript = default, string toScript = default, bool? allowFallback = default, System.Threading.CancellationToken cancellationToken = default);abstract member TranslateAsync : seq<string> * seq<string> * string * string * Nullable<Azure.AI.Translation.Text.TextType> * string * Nullable<Azure.AI.Translation.Text.ProfanityAction> * Nullable<Azure.AI.Translation.Text.ProfanityMarker> * Nullable<bool> * Nullable<bool> * string * string * string * Nullable<bool> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>>
override this.TranslateAsync : seq<string> * seq<string> * string * string * Nullable<Azure.AI.Translation.Text.TextType> * string * Nullable<Azure.AI.Translation.Text.ProfanityAction> * Nullable<Azure.AI.Translation.Text.ProfanityMarker> * Nullable<bool> * Nullable<bool> * string * string * string * Nullable<bool> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Collections.Generic.IReadOnlyList<Azure.AI.Translation.Text.TranslatedTextItem>>>Public Overridable Function TranslateAsync (targetLanguages As IEnumerable(Of String), content As IEnumerable(Of String), Optional clientTraceId As String = Nothing, Optional sourceLanguage As String = Nothing, Optional textType As Nullable(Of TextType) = Nothing, Optional category As String = Nothing, Optional profanityAction As Nullable(Of ProfanityAction) = Nothing, Optional profanityMarker As Nullable(Of ProfanityMarker) = Nothing, Optional includeAlignment As Nullable(Of Boolean) = Nothing, Optional includeSentenceLength As Nullable(Of Boolean) = Nothing, Optional suggestedFrom As String = Nothing, Optional fromScript As String = Nothing, Optional toScript As String = Nothing, Optional allowFallback As Nullable(Of Boolean) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of IReadOnlyList(Of TranslatedTextItem)))パラメーター
- targetLanguages
- IEnumerable<String>
出力テキストの言語を指定します。 ターゲット言語は、翻訳スコープに含まれるサポートされている言語のいずれかである必要があります。 たとえば、to=de を使用してドイツ語に翻訳します。 クエリ文字列内でパラメーターを繰り返すことにより、同時に複数の言語に翻訳することができます。 たとえば、to=de&to=it を使用してドイツ語とイタリア語に翻訳します。
- content
- IEnumerable<String>
翻訳するテキストの配列。
- clientTraceId
- String
要求を一意に識別する、クライアントで生成された GUID。
- sourceLanguage
- String
入力テキストの言語を指定します。 翻訳範囲を使用してサポートされている言語を検索して、翻訳に使用できる言語を見つけます。 from パラメーターが指定されていない場合は、ソース言語を決定するために自動言語検出が適用されます。
動的ディクショナリ機能を使用する場合は、自動検出ではなく from パラメーターを使用する必要があります。 注: 動的ディクショナリ機能では、大文字と小文字が区別されます。
翻訳するテキストがプレーン テキストか、それとも HTML テキストかを定義します。 HTML の場合は、適切な形式の完全な要素である必要があります。 使用できる値は、プレーン (既定値) または html です。
- category
- String
翻訳のカテゴリ (ドメイン) を指定する文字列。 このパラメーターは、Custom Translator でビルドしたカスタマイズされたシステムから翻訳を取得するために使用します。 デプロイ済みのカスタマイズされたシステムを使用するには、カスタム翻訳ツール プロジェクトの詳細からこのパラメーターにカテゴリ ID を追加します。 既定値は general です。
- profanityAction
- Nullable<ProfanityAction>
翻訳での不適切な表現の処理方法を指定します。 使用できる値は、NoAction (既定値)、マーク済み、または削除済みです。
- profanityMarker
- Nullable<ProfanityMarker>
翻訳での不適切な表現のマーキング方法を指定します。 使用できる値は、アスタリスク (既定値) または Tag です。
ソース テキストから翻訳済みテキストへのアライメント プロジェクションを含めるかどうかを指定します。 指定できる値は、true または false (既定値) です。
入力テキストと翻訳済みテキストに対して文の境界を含めるかどうかを指定します。 指定できる値は、true または false (既定値) です。
- suggestedFrom
- String
入力テキストの言語を識別できない場合のフォールバック言語を指定します。 from パラメーターを省略すると、言語自動検出が適用されます。 検出に失敗した場合、suggestedFrom 言語が想定されます。
- fromScript
- String
入力テキストのスクリプトを指定します。
- toScript
- String
翻訳済みテキストのスクリプトを指定します。
カスタム システムが存在しない場合に、サービスが一般的なシステムに切り替えられるよう指定します。 指定できる値は、true (既定値) または false です。
allowFallback=false は、要求で指定されたカテゴリに対してトレーニングされたシステムのみを翻訳で使用するように指定します。 言語 X から言語 Y への翻訳で、中心言語 E を経由するチェーン処理が必要な場合、チェーン内のすべてのシステム (X → E および E → Y) はカスタムであり、同じカテゴリを持っている必要があります。 特定のカテゴリを持つシステムが見つからない場合、要求は 400 状態コードを返します。 allowFallback=true は、カスタム システムが存在しない場合に、サービスが一般的なシステムにフォールバックすることを許可することを指定します。
- cancellationToken
- CancellationToken
使用する取り消しトークン。
戻り値
例外
targetLanguages または content が null です。
適用対象
Azure SDK for .NET