Использование API перевода с Python

1. Обзор

API для перевода предоставляет простой программный интерфейс для динамического перевода произвольной строки на любой поддерживаемый язык с использованием передовых нейронных технологий машинного перевода. Он также может использоваться для определения языка в случаях, когда исходный язык неизвестен.

В этом уроке вы будете использовать API перевода с Python. Рассматриваемые концепции включают в себя вывод списка доступных языков, перевод текста и определение языка заданного текста.

Что вы узнаете

• Как настроить свою среду
• Как отобразить список доступных языков
• Как перевести текст
• Как распознавать языки

Что вам понадобится

• Проект Google Cloud
• Браузер, например Chrome или Firefox.
• Знание языка Python

Опрос

Как вы будете использовать этот учебный материал?

Прочитайте только от начала до конца. Прочитайте текст и выполните упражнения.

Как бы вы оценили свой опыт работы с Python?

Новичок Средний Профессионал

Как бы вы оценили свой опыт использования сервисов Google Cloud?

Новичок Средний Профессионал

2. Настройка и требования

Настройка среды для самостоятельного обучения

1. Войдите в консоль Google Cloud и создайте новый проект или используйте существующий. Если у вас еще нет учетной записи Gmail или Google Workspace, вам необходимо ее создать .

• Название проекта — это отображаемое имя участников данного проекта. Это строка символов, не используемая API Google. Вы всегда можете его изменить.
• Идентификатор проекта уникален для всех проектов Google Cloud и является неизменяемым (его нельзя изменить после установки). Консоль Cloud автоматически генерирует уникальную строку; обычно вам неважно, какая она. В большинстве практических заданий вам потребуется указать идентификатор вашего проекта (обычно обозначается как PROJECT_ID ). Если сгенерированный идентификатор вас не устраивает, вы можете сгенерировать другой случайный идентификатор. В качестве альтернативы вы можете попробовать свой собственный и посмотреть, доступен ли он. После этого шага его нельзя изменить, и он сохраняется на протяжении всего проекта.
• К вашему сведению, существует третье значение — номер проекта , которое используется некоторыми API. Подробнее обо всех трех значениях можно узнать в документации .

Внимание: Идентификатор проекта является уникальным во всем мире и не может быть использован кем-либо еще после того, как вы его выбрали. Вы являетесь единственным пользователем этого идентификатора. Даже если проект будет удален, идентификатор нельзя будет использовать снова.

Примечание: Если вы используете учетную запись Gmail, вы можете оставить значение по умолчанию « Без организации» . Если вы используете учетную запись Google Workspace, выберите местоположение, которое подходит для вашей организации.

2. Далее вам потребуется включить оплату в консоли Cloud для использования ресурсов/API Cloud. Выполнение этого практического задания не потребует больших затрат, если вообще потребует. Чтобы отключить ресурсы и избежать дополнительных расходов после завершения этого урока, вы можете удалить созданные ресурсы или удалить проект. Новые пользователи Google Cloud имеют право на бесплатную пробную версию стоимостью 300 долларов США .

Запустить Cloud Shell

Хотя Google Cloud можно управлять удаленно с ноутбука, в этом практическом занятии вы будете использовать Cloud Shell — среду командной строки, работающую в облаке.

Активировать Cloud Shell

1. В консоли Cloud нажмите «Активировать Cloud Shell» . .

Если вы запускаете Cloud Shell впервые, вам будет показан промежуточный экран с описанием его возможностей. Если вам был показан промежуточный экран, нажмите «Продолжить» .

Подготовка и подключение к Cloud Shell займут всего несколько минут.

Эта виртуальная машина оснащена всеми необходимыми инструментами разработки. Она предоставляет постоянный домашний каталог объемом 5 ГБ и работает в облаке Google, что значительно повышает производительность сети и аутентификацию. Большая часть, если не вся, ваша работа в этом практическом задании может быть выполнена с помощью браузера.

После подключения к Cloud Shell вы увидите, что прошли аутентификацию и что проект настроен на ваш идентификатор проекта.

2. Выполните следующую команду в Cloud Shell, чтобы подтвердить свою аутентификацию:

gcloud auth list

вывод команды

 Credentialed Accounts
ACTIVE  ACCOUNT
*       <my_account>@<my_domain.com>

To set the active account, run:
    $ gcloud config set account `ACCOUNT`

Примечание: Инструмент командной строки gcloud — это мощный и унифицированный инструмент командной строки в Google Cloud. Он предустановлен в Cloud Shell. Вы заметите поддержку автодополнения (Tab). При первом запуске команды может потребоваться аутентификация. Для получения дополнительной информации см. обзор инструмента командной строки gcloud .

3. Выполните следующую команду в Cloud Shell, чтобы убедиться, что команда gcloud знает о вашем проекте:

gcloud config list project

вывод команды

[core]
project = <PROJECT_ID>

Если это не так, вы можете установить это с помощью следующей команды:

gcloud config set project <PROJECT_ID>

вывод команды

Updated property [core/project].

Примечание: Если вы выполняете это руководство вне Cloud Shell, следуйте инструкциям в разделе «Настройка учетных данных приложения по умолчанию» .

3. Настройка среды

Прежде чем начать использовать API перевода, выполните следующую команду в Cloud Shell, чтобы включить API:

gcloud services enable translate.googleapis.com

Вы должны увидеть что-то подобное:

Operation "operations/..." finished successfully.

Теперь вы можете использовать API перевода!

Установите следующую переменную среды (которая будет использоваться в вашем приложении):

export PROJECT_ID=$(gcloud config get-value core/project)

echo "PROJECT_ID: $PROJECT_ID"

Примечание: Эта переменная окружения применяется только к текущей сессии оболочки. Поэтому, если вы откроете новую сессию, установите эту переменную снова.

Перейдите в свою домашнюю директорию:

cd ~

Создайте виртуальное окружение Python для изоляции зависимостей:

virtualenv venv-translate

Активируйте виртуальную среду:

source venv-translate/bin/activate

Примечание: Чтобы прекратить использование виртуальной среды и вернуться к системной версии Python, вы можете использовать команду deactivate .

Установите IPython и клиентскую библиотеку Translation API:

pip install ipython google-cloud-translate

Вы должны увидеть что-то подобное:

...
Installing collected packages: ..., ipython, google-cloud-translate
Successfully installed ... google-cloud-translate-3.16.0 ...

Теперь вы готовы использовать клиентскую библиотеку Translation API!

Примечание: Если вы настраиваете собственную среду разработки Python вне Cloud Shell, вы можете следовать этим рекомендациям .

На следующих шагах вы будете использовать интерактивный интерпретатор Python под названием IPython , который вы установили на предыдущем шаге. Чтобы начать сессию, запустите ipython в Cloud Shell:

ipython

Вы должны увидеть что-то подобное:

Python 3.10.12 (main, Jul 29 2024, 16:56:48) [GCC 11.4.0]
Type 'copyright', 'credits' or 'license' for more information
IPython 8.27.0 -- An enhanced Interactive Python. Type '?' for help.

In [1]:

Примечание: При необходимости вы можете завершить сессию IPython с помощью команды exit .

Скопируйте следующий код в свою сессию IPython:

from os import environ

from google.cloud import translate


PROJECT_ID = environ.get("PROJECT_ID", "")
assert PROJECT_ID
PARENT = f"projects/{PROJECT_ID}"

Примечания:

• Здесь используется переменная среды PROJECT_ID , определенная ранее.
• Переменная PARENT будет использоваться для запросов на следующих этапах. Она указывает на проект вызывающей стороны.

Вы готовы отправить свой первый запрос и перечислить поддерживаемые языки...

4. Перечислите доступные языки.

В этом разделе вы перечислите все доступные языки в API перевода.

Чтобы отобразить список доступных языков, скопируйте следующий код в свою сессию IPython:

def print_supported_languages(display_language_code: str):
    client = translate.TranslationServiceClient()

    response = client.get_supported_languages(
        parent=PARENT,
        display_language_code=display_language_code,
    )

    languages = response.languages
    print(f" Languages: {len(languages)} ".center(60, "-"))
    for language in languages:
        language_code = language.language_code
        display_name = language.display_name
        print(f"{language_code:10}{display_name}")
    

Вызовите функцию:

print_supported_languages("en")

В итоге у вас должно получиться что-то подобное:

---------------------- Languages: 137 ----------------------
af        Afrikaans
sq        Albanian
am        Amharic
ar        Arabic
hy        Armenian
...
cy        Welsh
xh        Xhosa
yi        Yiddish
yo        Yoruba
zu        Zulu

Если вы получили ошибку PermissionDenied , введите exit , чтобы выйти из IPython, и вернитесь к шагу «Настройка и требования» .

Посмотрите, что вы получите, выбрав французский язык отображения:

print_supported_languages("fr")

В результате вы должны получить тот же список, отсортированный по французским названиям, примерно следующего вида:

---------------------- Languages: 137 ----------------------
af        Afrikaans
sq        Albanais
de        Allemand
am        Amharique
en        Anglais
...
vi        Vietnamien
xh        Xhosa
yi        Yiddish
yo        Yoruba
zu        Zoulou

Вы можете попробовать использовать другой код языка .

Краткое содержание

На этом шаге вы смогли перечислить все доступные языки в API перевода. Полный список поддерживаемых языков вы найдете на странице поддержки языков .

5. Переведите текст

Вы можете использовать API перевода для перевода текста с одного языка на другой. Перевод текста осуществляется с помощью модели нейронного машинного перевода (NMT). Если модель NMT не поддерживается для запрошенной пары языков, используется модель фразового машинного перевода (PBMT). Более подробную информацию о Google Translate и его моделях перевода можно найти в сообщении об анонсе NMT .

Для перевода текста скопируйте следующий код в сессию IPython:

def translate_text(text: str, target_language_code: str) -> translate.Translation:
    client = translate.TranslationServiceClient()

    response = client.translate_text(
        parent=PARENT,
        contents=[text],
        target_language_code=target_language_code,
    )

    return response.translations[0]
    

Вызовите функцию для перевода одного и того же текста на разные языки:

text = "Hello World!"
target_languages = ["tr", "de", "es", "it", "el", "zh", "ja", "ko"]

print(f" {text} ".center(50, "-"))
for target_language in target_languages:
    translation = translate_text(text, target_language)
    source_language = translation.detected_language_code
    translated_text = translation.translated_text
    print(f"{source_language} → {target_language} : {translated_text}")
    

В результате вы должны получить следующее:

------------------ Hello World! ------------------
en → tr : Selam Dünya!
en → de : Hallo Welt!
en → es : ¡Hola Mundo!
en → it : Ciao mondo!
en → el : Γεια σου Κόσμο!
en → zh : 你好世界！
en → ja : 「こんにちは世界」
en → ko : 안녕하세요!

Краткое содержание

На этом этапе вы смогли использовать API перевода для перевода текста на несколько языков. Подробнее о переводе текста читайте здесь.

6. Определение языков

Вы также можете использовать API перевода для определения языка текстовой строки.

Скопируйте следующий код в свою сессию IPython:

def detect_language(text: str) -> translate.DetectedLanguage:
    client = translate.TranslationServiceClient()

    response = client.detect_language(parent=PARENT, content=text)

    return response.languages[0]
    

Вызовите функцию для определения языка различных предложений:

sentences = [
    "Selam Dünya!",
    "Hallo Welt!",
    "¡Hola Mundo!",
    "Ciao mondo!",
    "Γεια σου Κόσμο!",
    "你好世界！",
    "「こんにちは世界」",
    "안녕하세요!",
]
for sentence in sentences:
    language = detect_language(sentence)
    confidence = language.confidence
    language_code = language.language_code
    print(
        f"Confidence: {confidence:4.0%}",
        f"Language: {language_code:5}",
        sentence,
        sep=" | ",
    )
    

В результате вы должны получить следующее:

Confidence: 100% | Language: tr    | Selam Dünya!
Confidence:  81% | Language: de    | Hallo Welt!
Confidence: 100% | Language: es    | ¡Hola Mundo!
Confidence: 100% | Language: it    | Ciao mondo!
Confidence: 100% | Language: el    | Γεια σου Κόσμο!
Confidence: 100% | Language: zh-CN | 你好世界！
Confidence: 100% | Language: ja    | 「こんにちは世界」
Confidence: 100% | Language: ko    | 안녕하세요!

Краткое содержание

На этом этапе вы смогли определить язык текста с помощью API перевода. Подробнее об определении языков читайте здесь.

7. Поздравляем!

Вы научились использовать API перевода с помощью Python!

Уборка

Для очистки среды разработки используйте Cloud Shell:

• Если вы всё ещё находитесь в сессии IPython, вернитесь в командную оболочку: exit
• Прекратите использование виртуальной среды Python: deactivate
• Удалите папку виртуального окружения: cd ~ ; rm -rf ./venv-translate

Чтобы удалить свой проект Google Cloud, используйте Cloud Shell:

• Получите текущий идентификатор проекта: PROJECT_ID=$(gcloud config get-value core/project)
• Убедитесь, что это именно тот проект, который вы хотите удалить: echo $PROJECT_ID
• Удалите проект: gcloud projects delete $PROJECT_ID

Узнать больше

• Документация по облачному переводу: https://cloud.google.com/translate/docs
• Python в Google Cloud: https://cloud.google.com/python
• Клиентские библиотеки для облачных сервисов на Python: https://github.com/googleapis/google-cloud-python

Лицензия

Данная работа распространяется под лицензией Creative Commons Attribution 2.0 Generic.