Использование Google Translate API с PHP

Запрос образца

Перевод и обнаружение услуг платные, но мы можем использовать третий метод — языки — просто чтобы проверить, может ли наше приложение соединиться с API. Для этого мы сделаем запрос по следующему URL: https://www.googleapis.com/language/translate/v2/languages

Весь код выглядит следующим образом:

 <?php
    $apiKey = '<paste your API key here>';
    $url = 'https://www.googleapis.com/language/translate/v2/languages?key=' . $apiKey;

    $handle = curl_init($url);
    curl_setopt($handle, CURLOPT_RETURNTRANSFER, true);     //We want the result to be saved into variable, not printed out
    $response = curl_exec($handle);                         
    curl_close($handle);

    print_r(json_decode($response, true));
?>

После выполнения приведенного выше кода вы должны увидеть массив всех языков, которые могут быть обработаны API Google Translate. Аналогичная таблица доступна в документации . Важно просмотреть эту таблицу, потому что вам нужно будет указать коды языков, указанные там при отправке запроса на перевод конкретного текста.

Получение переводов

Основная функциональность API Google Translate доступна через метод перевода . Он доступен по следующему URL-адресу: https://www.googleapis.com/language/translate/v2

Метод перевода имеет несколько параметров. Наиболее важными являются:
— q — ввод текста,
— source — исходный язык (если он не указан, Google попытается определить его автоматически),
— target — целевой язык

Если вы хотите получить переведенный текст, вы должны изменить URL-адрес запроса из предыдущего примера. Остальная часть кода выглядит очень похоже:

 <?php
    $apiKey = '<paste your API key here>';
    $text = 'Hello world!';
    $url = 'https://www.googleapis.com/language/translate/v2?key=' . $apiKey . '&q=' . rawurlencode($text) . '&source=en&target=fr';

    $handle = curl_init($url);
    curl_setopt($handle, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($handle);                 
    $responseDecoded = json_decode($response, true);
    curl_close($handle);

    echo 'Source: ' . $text . '<br>';
    echo 'Translation: ' . $responseDecoded['data']['translations'][0]['translatedText'];
?>

Пример ответа, содержащий переведенный текст, выглядит следующим образом:

 {
 "data": {
  "translations": [{"translatedText": "Bonjour tout le monde!"}]
 }
}

Что произойдет, если вы не установите исходный язык?

Если вы решите не включать исходный язык (параметр источника ) в запрос, могут возникнуть два сценария:
1. Google удастся определить язык самостоятельно, поэтому ответ JSON будет содержать дополнительное свойство детектированное обнаружение ресурса, содержащее код исходного языка.
2. Исходный язык не будет успешно обнаружен (например, если исходный текст был слишком коротким), и Google Translate API вернет ошибку HTTP 500. Это приводит к следующей части урока — обработка ошибок.

Обработка ошибок

Если ваш запрос не может быть обработан, Google Translate API возвращает HTTP-ответ с кодом, представляющим тип ошибки. После выполнения запроса с использованием cURL вы можете получить код ответа сервера с помощью функции curl_getinfo () . Если код ответа отличается от 200 , это означает, что что-то пошло не так.

API Google Translate может возвращать следующие коды ошибок:
— 400 ( неверный запрос) — в вашем запросе отсутствуют некоторые параметры или вы передали неправильные значения параметрам, присутствующим в запросе (например, неверный код языка),
— 403 (запрещено) — вы ввели неверный ключ API или превысили квоту,
— 500 (Внутренняя ошибка сервера) — Google не может определить исходный язык вашего текста или произошла другая ошибка.

Кроме того, при возникновении ошибки API Google Translate возвращает ответ JSON, содержащий описание ошибки. Например, если один из обязательных параметров отсутствует, сервер ответит следующим ответом:

 {
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "required",
    "message": "Required parameter: target",
    "locationType": "parameter",
    "location": "target"
   }
  ],
  "code": 400,
  "message": "Required parameter: target"
 }
}

Поэтому лучший способ обработки ошибок при обращении к сервису API Google Translate — это просто совмещать проверку кода ответа HTTP и анализ ответа JSON с сервера. Что важно, curl_getinfo () должен быть вызван до curl_close () :

 <?php
    $apiKey = '<paste your API key here>';
    $text = 'Hello world!';
    $url = 'https://www.googleapis.com/language/translate/v2?key=' . $apiKey . '&q=' . rawurlencode($text) . '&source=en&target=fr';

    $handle = curl_init($url);
    curl_setopt($handle, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($handle);
    $responseDecoded = json_decode($response, true);
    $responseCode = curl_getinfo($handle, CURLINFO_HTTP_CODE);      //Here we fetch the HTTP response code
    curl_close($handle);

    if($responseCode != 200) {
        echo 'Fetching translation failed! Server response code:' . $responseCode . '<br>';
        echo 'Error description: ' . $responseDecoded['error']['errors'][0]['message'];
    }
    else {
        echo 'Source: ' . $text . '<br>';
        echo 'Translation: ' . $responseDecoded['data']['translations'][0]['translatedText'];
    }
?>

Несколько переводов в одном запросе

Вы можете перевести несколько текстов за один запрос, что, несомненно, более эффективно, чем выполнение отдельного запроса для каждого перевода. Для этого просто передайте пару параметров q , каждый из которых содержит один текст для перевода.

Тем не менее, здесь становится немного сложно:
— если все ваши исходные тексты написаны на одном языке, вы можете передать параметр источника, содержащий код языка всех текстов;
— но если вы хотите перевести пару текстов на разные языки, вы не можете передать несколько параметров источника . В таком случае вам нужно пропустить параметр источника и просто дать Google угадать, на каких языках используются исходные тексты.

Также обратите внимание, что вы не можете получить несколько переводов одного исходного текста в одном запросе. Если вы хотите перевести один текст на разные целевые языки, вы должны сделать отдельные запросы.

Вывод

Теперь вы знаете основы подключения вашего приложения к Google Translate API. Более сложные реализации API могут включать автоматическую выборку переводов, когда пользователь отправляет некоторый контент (или когда администратор сайта одобряет это), и сохранение переводов в базе данных. Мы расскажем о таких продвинутых примерах в следующей статье (часть 2 здесь ).

Если вы планируете использовать API Google Translate в своем приложении, не забудьте прочитать Условия предоставления услуг и требования к атрибуции, которые содержат несколько рекомендаций о том, как отображать переведенный контент на веб-странице.

Если у вас есть какие-либо вопросы или комментарии относительно статьи, не стесняйтесь оставлять комментарии ниже или свяжитесь со мной через Google+ .