PHP Class Google\Cloud\Translate\TranslateClient

Please note that unlike most other Cloud Platform services Google Translate requires a public API access key and cannot currently be accessed with a service account or application default credentials. Follow the before you begin instructions to learn how to generate a key. Example: use Google\Cloud\ServiceBuilder; $cloud = new ServiceBuilder([ 'key' => 'YOUR_KEY' ]); $translate = $cloud->translate(); TranslateClient can be instantiated directly. use Google\Cloud\Translate\TranslateClient; $translate = new TranslateClient([ 'key' => 'YOUR_KEY' ]);
Inheritance: use trait Google\Cloud\ClientTrait
Mostrar archivo Open project: GoogleCloudPlatform/gcloud-php

Protected Properties

Property Type Description
$connection Google\Cloud\Translate\Connection\ConnectionInterface

Public Methods

Method Description
__construct ( array $config = [] ) Create a Translate client.
detectLanguage ( string $string, array $options = [] ) : array Detect the language of a string.
detectLanguageBatch ( array $strings, array $options = [] ) : array Detect the language of multiple strings.
languages ( array $options = [] ) : array Get all supported languages.
localizedLanguages ( array $options = [] ) : array Get the supported languages for translation in the targeted language.
translate ( string $string, array $options = [] ) : array | null Translate a string from one language to another.
translateBatch ( array $strings, array $options = [] ) : array Translate multiple strings from one language to another.

Method Details

__construct() public method

Create a Translate client.
public __construct ( array $config = [] )
$config array [optional] { Configuration Options. @type string $key A public API access key. @type string $target The target language to assign to the client. Must be a valid ISO 639-1 language code. **Defaults to** `"en"` (English). @type int $retries Number of retries for a failed request. **Defaults to** `3`. @type string $projectId The project ID from the Google Developer's Console. @type CacheItemPoolInterface $authCache A cache used storing access tokens. **Defaults to** a simple in memory implementation. @type array $authCacheOptions Cache configuration options. @type callable $authHttpHandler A handler used to deliver Psr7 requests specifically for authentication. @type callable $httpHandler A handler used to deliver Psr7 requests. Only valid for requests sent over REST. @type string $keyFile The contents of the service account credentials .json file retrieved from the Google Developers Console. @type string $keyFilePath The full path to your service account credentials .json file retrieved from the Google Developers Console. @type int $retries Number of retries for a failed request. **Defaults to** `3`. @type array $scopes Scopes to be used for the request. }

detectLanguage() public method

Example: $result = $translate->detectLanguage('Hello world!'); echo $result['languageCode'];
See also: https://cloud.google.com/translate/v2/detecting-language-with-rest Detecting Langauge
public detectLanguage ( string $string, array $options = [] ) : array
$string string The string to detect the language of.
$options array [optional] { Configuration Options. @type string $format Indicates whether the string is either plain-text or HTML. Acceptable values are `html` or `text`. **Defaults to** `"html"`. }
return array A result including a `languageCode` key containing the detected ISO 639-1 language code, an `input` key containing the original string, and in most cases a `confidence` key containing a value between 0 - 1 signifying the confidence of the result.

detectLanguageBatch() public method

Example: $results = $translate->detectLanguageBatch([ 'Hello World!', 'My name is David.' ]); foreach ($results as $result) { echo $result['languageCode']; }
See also: https://cloud.google.com/translate/v2/detecting-language-with-rest Detecting Langauge
public detectLanguageBatch ( array $strings, array $options = [] ) : array
$strings array
$options array [optional] { Configuration Options. @type string $format Indicates whether the string is either plain-text or HTML. Acceptable values are `html` or `text`. **Defaults to** `"html"`. }
return array A set of results. Each result includes a `languageCode` key containing the detected ISO 639-1 language code, an `input` key containing the original string, and in most cases a `confidence` key containing a value between 0 - 1 signifying the confidence of the result.

languages() public method

Example: $languages = $translate->languages(); foreach ($languages as $language) { echo $language; }
See also: https://cloud.google.com/translate/v2/discovering-supported-languages-with-rest Discovering Supported Languages
public languages ( array $options = [] ) : array
$options array [optional] Configuration Options.
return array A list of supported ISO 639-1 language codes.

localizedLanguages() public method

Unlike {@see \Google\Cloud\Translate\TranslateClient::languages()} this will return the localized language names in addition to the ISO 639-1 language codes. Example: $languages = $translate->localizedLanguages(); foreach ($languages as $language) { echo $language['code']; }
See also: https://cloud.google.com/translate/v2/discovering-supported-languages-with-rest Discovering Supported Languages
public localizedLanguages ( array $options = [] ) : array
$options array [optional] { Configuration Options. @type string $target The language to discover supported languages for. Must be a valid ISO 639-1 language code. **Defaults to** the value assigned to the client (`"en"` by default). }
return array A set of language results. Each result includes a `code` key containing the ISO 639-1 code for the supported language and a `name` key containing the name of the language written in the target language.

translate() public method

Example: $translation = $translate->translate('Hello world!'); echo $translation['text'];
See also: https://cloud.google.com/translate/v2/translating-text-with-rest Translating Text
public translate ( string $string, array $options = [] ) : array | null
$string string The string to translate.
$options array [optional] { Configuration Options. @type string $source The source language to translate from. Must be a valid ISO 639-1 language code. If not provided the value will be automatically detected by the server. @type string $target The target language to translate to. Must be a valid ISO 639-1 language code. **Defaults to** the value assigned to the client (`"en"` by default). @type string $format Indicates whether the string to be translated is either plain-text or HTML. Acceptable values are `html` or `text`. **Defaults to** `"html"`. @type string $model The model to use for the translation request. May be `nmt` or `base`. **Defaults to** an empty string. }
return array | null A translation result including a `source` key containing the detected or provided langauge of the provided input, an `input` key containing the original string, and a `text` key containing the translated result.

translateBatch() public method

Example: $translations = $translate->translateBatch([ 'Hello world!', 'My name is David.' ]); foreach ($translations as $translation) { echo $translation['text']; }
See also: https://cloud.google.com/translate/v2/translating-text-with-rest Translating Text
public translateBatch ( array $strings, array $options = [] ) : array
$strings array An array of strings to translate.
$options array [optional] { Configuration Options. @type string $source The source language to translate from. Must be a valid ISO 639-1 language code. If not provided the value will be automatically detected by the server. @type string $target The target language to translate to. Must be a valid ISO 639-1 language code. **Defaults to** the value assigned to the client (`"en"` by default). @type string $format Indicates whether the string to be translated is either plain-text or HTML. Acceptable values are `html` or `text`. **Defaults to** `"html"`. @type string $model The model to use for the translation request. May be `nmt` or `base`. **Defaults to** an empty string. }
return array A set of translation results. Each result includes a `source` key containing the detected or provided language of the provided input, an `input` key containing the original string, and a `text` key containing the translated result.

Property Details

$connection protected_oe property

protected ConnectionInterface,Google\Cloud\Translate\Connection $connection
return Google\Cloud\Translate\Connection\ConnectionInterface