Google Cloud Translation v2 API - Class AdvancedTranslationClientImpl (3.2.0-beta01)

public sealed class AdvancedTranslationClientImpl : AdvancedTranslationClient, IDisposable

Reference documentation and code samples for the Google Cloud Translation v2 API class AdvancedTranslationClientImpl.

Wrapper around TranslateService to provide simpler operations.

Inheritance

Object > AdvancedTranslationClient > AdvancedTranslationClientImpl

Implements

IDisposable

Inherited Members

AdvancedTranslationClient.TranslateText(String, String, String, String)

AdvancedTranslationClient.TranslateHtml(String, String, String, String)

AdvancedTranslationClient.DetectLanguage(String)

AdvancedTranslationClient.TranslateTextAsync(String, String, String, String, CancellationToken)

AdvancedTranslationClient.TranslateHtmlAsync(String, String, String, String, CancellationToken)

AdvancedTranslationClient.DetectLanguageAsync(String, CancellationToken)

AdvancedTranslationClient.CreateAsync()

AdvancedTranslationClient.Create()

AdvancedTranslationClient.CreateAsync(GoogleCredential, String)

AdvancedTranslationClient.CreateFromApiKey(String, String)

AdvancedTranslationClient.Create(GoogleCredential, String)

Object.GetHashCode()

Object.GetType()

Object.MemberwiseClone()

Object.ToString()

Namespace

Google.Cloud.Translation.V2

Assembly

Google.Cloud.Translation.V2.dll

Remarks

This is the "default" implementation of AdvancedTranslationClient. Most client code should refer to AdvancedTranslationClient, creating instances with Create(GoogleCredential, String), CreateAsync(GoogleCredential, String) and CreateFromApiKey(String, String). The constructor of this class is public for the sake of constructor-based dependency injection.

Constructors

AdvancedTranslationClientImpl(TranslateService, String)

public AdvancedTranslationClientImpl(TranslateService service, string model = null)

Constructs a new client wrapping the given TranslateService.

Parameters
Name	Description
`service`	`TranslateService` The service to wrap. Must not be null.
`model`	`String` The default translation model to use. Defaults to null, indicating that by default no model is specified in requests.

Properties

ApplicationName

public static string ApplicationName { get; set; }

The default application name used when creating a TranslateService. Defaults to "google-cloud-dotnet"; must not be null.

Property Value
Type	Description
`String`

Remarks

Most applications will never want to set this, which is why it's in this class rather than AdvancedTranslationClient.

DefaultModel

public override string DefaultModel { get; }

The default translation model used by this client.

Property Value
Type	Description
`String`

Overrides

AdvancedTranslationClient.DefaultModel

Remarks

Each Translate method has an optional parameter to override this.

Service

public override TranslateService Service { get; }

The underlying translation service object used by this client.

Property Value
Type	Description
`TranslateService`

Overrides

AdvancedTranslationClient.Service

Remarks

The AdvancedTranslationClient class only provides convenience operations built on top of an existing service object. Any more complex operations which are not supported by this wrapper may wish to use the same service object as the wrapper, in order to take advantage of its configuration (for authentication, application naming etc).

Methods

DetectLanguages(IEnumerable<String>)

public override IList<Detection> DetectLanguages(IEnumerable<string> textItems)

Detects the languages of the specified text items synchronously.

Parameter
Name	Description
`textItems`	`IEnumerable<String>` The text items to detect the language of. Must not be null or contain null elements.

Returns
Type	Description
`IList<Detection>`	A list of detected languages. This will be the same size as `textItems`, in the same order.

Overrides

AdvancedTranslationClient.DetectLanguages(IEnumerable<String>)

DetectLanguagesAsync(IEnumerable<String>, CancellationToken)

public override async Task<IList<Detection>> DetectLanguagesAsync(IEnumerable<string> textItems, CancellationToken cancellationToken = default(CancellationToken))

Detects the languages of the specified text items asynchronously.

Parameters
Name	Description
`textItems`	`IEnumerable<String>` The text items to detect the language of. Must not be null or contain null elements.
`cancellationToken`	`CancellationToken` The token to monitor for cancellation requests.

Returns
Type	Description
`Task<IList<Detection>>`	A list of detected languages. This will be the same size as `textItems`, in the same order.

Overrides

AdvancedTranslationClient.DetectLanguagesAsync(IEnumerable<String>, CancellationToken)

Dispose()

public override void Dispose()

Dispose of this instance. See the AdvancedTranslationClient remarks on when this should be called.

Overrides

AdvancedTranslationClient.Dispose()

ListLanguages(String, String)

public override IList<Language> ListLanguages(string target = null, string model = null)

Lists the language supported by the Translate API synchronously.

Parameters
Name	Description
`target`	`String` The target language in which to return the language names in the results, for display purposes. May be null, in which case only the language codes are returned.
`model`	`String` The model to request languages for. May be null, in which case DefaultModel is used. If the empty string is specified, no model is requested, allowing the server to choose.

Returns
Type	Description
`IList<Language>`	A list of supported languages.

Overrides

AdvancedTranslationClient.ListLanguages(String, String)

ListLanguagesAsync(String, String, CancellationToken)

public override async Task<IList<Language>> ListLanguagesAsync(string target = null, string model = null, CancellationToken cancellationToken = default(CancellationToken))

Lists the language supported by the Translate API asynchronously.

Parameters
Name	Description
`target`	`String` The target language in which to return the language names in the results, for display purposes. May be null, in which case only the language codes are returned.
`model`	`String` The model to request languages for. May be null, in which case DefaultModel is used. If the empty string is specified, no model is requested, allowing the server to choose.
`cancellationToken`	`CancellationToken` The token to monitor for cancellation requests.

Returns
Type	Description
`Task<IList<Language>>`	A list of supported languages.

Overrides

AdvancedTranslationClient.ListLanguagesAsync(String, String, CancellationToken)

TranslateHtml(IEnumerable<String>, String, String, String)

public override IList<TranslationResult> TranslateHtml(IEnumerable<string> htmlItems, string targetLanguage, string sourceLanguage = null, string model = null)

Translates multiple items of HTML synchronously.

Parameters
Name	Description
`htmlItems`	`IEnumerable<String>` The HTML strings to translate. Must not be null or contain null elements.
`targetLanguage`	`String` The code for the language to translate into. Must not be null.
`sourceLanguage`	`String` The code for the language to translate from. May be null, in which case the server will detect the source language.
`model`	`String` The model to request for translation. May be null, in which case DefaultModel is used. If the empty string is specified, no model is requested, allowing the server to choose.

Returns
Type	Description
`IList<TranslationResult>`	A list of translations. This will be the same size as `htmlItems`, in the same order.

Overrides

AdvancedTranslationClient.TranslateHtml(IEnumerable<String>, String, String, String)

Remarks

See the Translation API documentation for more details on how to translate HTML and the terms of service.

TranslateHtmlAsync(IEnumerable<String>, String, String, String, CancellationToken)

public override async Task<IList<TranslationResult>> TranslateHtmlAsync(IEnumerable<string> htmlItems, string targetLanguage, string sourceLanguage = null, string model = null, CancellationToken cancellationToken = default(CancellationToken))

Translates multiple items of HTML asynchronously.

Parameters
Name	Description
`htmlItems`	`IEnumerable<String>` The HTML strings to translate. Must not be null or contain null elements.
`targetLanguage`	`String` The code for the language to translate into. Must not be null.
`sourceLanguage`	`String` The code for the language to translate from. May be null, in which case the server will detect the source language.
`model`	`String` The model to request for translation. May be null, in which case DefaultModel is used. If the empty string is specified, no model is requested, allowing the server to choose.
`cancellationToken`	`CancellationToken` The token to monitor for cancellation requests.

Returns
Type	Description
`Task<IList<TranslationResult>>`	A list of translations. This will be the same size as `htmlItems`, in the same order.

Overrides

AdvancedTranslationClient.TranslateHtmlAsync(IEnumerable<String>, String, String, String, CancellationToken)

Remarks

See the Translation API documentation for more details on how to translate HTML and the terms of service.

TranslateText(IEnumerable<String>, String, String, String)

public override IList<TranslationResult> TranslateText(IEnumerable<string> textItems, string targetLanguage, string sourceLanguage = null, string model = null)

Translates multiple items of text synchronously.

Parameters
Name	Description
`textItems`	`IEnumerable<String>` The text strings to translate. Must not be null or contain null elements.
`targetLanguage`	`String` The code for the language to translate into. Must not be null.
`sourceLanguage`	`String` The code for the language to translate from. May be null, in which case the server will detect the source language.
`model`	`String` The model to request for translation. May be null, in which case DefaultModel is used. If the empty string is specified, no model is requested, allowing the server to choose.

Returns
Type	Description
`IList<TranslationResult>`	A list of translations. This will be the same size as `textItems`, in the same order.

Overrides

AdvancedTranslationClient.TranslateText(IEnumerable<String>, String, String, String)

TranslateTextAsync(IEnumerable<String>, String, String, String, CancellationToken)

public override async Task<IList<TranslationResult>> TranslateTextAsync(IEnumerable<string> textItems, string targetLanguage, string sourceLanguage = null, string model = null, CancellationToken cancellationToken = default(CancellationToken))

Translates multiple items of text asynchronously.

Parameters
Name	Description
`textItems`	`IEnumerable<String>` The text strings to translate. Must not be null or contain null elements.
`targetLanguage`	`String` The code for the language to translate into. Must not be null.
`sourceLanguage`	`String` The code for the language to translate from. May be null, in which case the server will detect the source language.
`model`	`String` The model to request for translation. May be null, in which case DefaultModel is used. If the empty string is specified, no model is requested, allowing the server to choose.
`cancellationToken`	`CancellationToken` The token to monitor for cancellation requests.

Returns
Type	Description
`Task<IList<TranslationResult>>`	A list of translations. This will be the same size as `textItems`, in the same order.

Overrides

AdvancedTranslationClient.TranslateTextAsync(IEnumerable<String>, String, String, String, CancellationToken)