/// <summary>
/// Starts a translation operation which translates the document(s) in your source container
/// to your <see cref="TranslationTarget"/>(s) in the given language.
/// <para>For document length limits, maximum batch size, and supported document formats, see
/// <a href="https://docs.microsoft.com/azure/cognitive-services/translator/document-translation/overview"/>.</para>
/// </summary>
/// <param name="input">Sets the input for the translation operation
/// including source and target containers for documents to be translated. </param>
/// <param name="cancellationToken">A <see cref="CancellationToken"/> controlling the request lifetime.</param>
/// <exception cref="RequestFailedException">Service returned a non-success status code. </exception>
public virtual DocumentTranslationOperation StartTranslation(DocumentTranslationInput input, CancellationToken cancellationToken = default)
{
Argument.AssertNotNull(input, nameof(input));
var request = new StartTranslationDetails(new List<DocumentTranslationInput> { input });
using DiagnosticScope scope = _clientDiagnostics.CreateScope($"{nameof(DocumentTranslationClient)}.{nameof(StartTranslation)}");
scope.Start();
try
{
ResponseWithHeaders<DocumentTranslationStartTranslationHeaders> job = _serviceRestClient.StartTranslation(request, cancellationToken);
return new DocumentTranslationOperation(_serviceRestClient, _clientDiagnostics, job.Headers.OperationLocation);
}
catch (Exception e)
{
scope.Failed(e);
throw;
}
}
/// <summary>
/// Starts a translation operation which translates the document(s) in your source container
/// to your <see cref="TranslationTarget"/>(s) in the given language.
/// <para>For document length limits, maximum batch size, and supported document formats, see
/// <a href="https://docs.microsoft.com/azure/cognitive-services/translator/document-translation/overview"/>.</para>
/// </summary>
/// <param name="input">Sets the input for the translation operation
/// including source and target containers for documents to be translated. </param>
/// <param name="cancellationToken">A <see cref="CancellationToken"/> controlling the request lifetime.</param>
/// <exception cref="RequestFailedException">Service returned a non-success status code. </exception>
public virtual async Task <DocumentTranslationOperation> StartTranslationAsync(DocumentTranslationInput input, CancellationToken cancellationToken = default)
{
Argument.AssertNotNull(input, nameof(input));
var request = new BatchSubmissionRequest(new List <DocumentTranslationInput> {
input
});
using DiagnosticScope scope = _clientDiagnostics.CreateScope($"{nameof(DocumentTranslationClient)}.{nameof(StartTranslation)}");
scope.Start();
try
{
ResponseWithHeaders <DocumentTranslationSubmitBatchRequestHeaders> job = await _serviceRestClient.SubmitBatchRequestAsync(request, cancellationToken).ConfigureAwait(false);
return(new DocumentTranslationOperation(_serviceRestClient, _clientDiagnostics, job.Headers.OperationLocation));
}
catch (Exception e)
{
scope.Failed(e);
throw;
}
}
