استخدام واجهة برمجة التطبيقات Translation API مع لغة Python

1. نظرة عامة

توفّر Translation API واجهة آلية بسيطة لترجمة أي سلسلة نصية بشكل ديناميكي إلى أي لغة متاحة باستخدام أحدث تقنيات "الترجمة الآلية العصبية". ويمكن استخدامها أيضًا لرصد لغة في الحالات التي تكون فيها اللغة المصدر غير معروفة.

في هذا البرنامج التعليمي، ستستخدم Translation API مع Python. تشمل المفاهيم التي يتم تناولها كيفية إدراج اللغات المتاحة وترجمة النصوص واكتشاف لغة نص معيّن.

ما ستتعلمه

• كيفية إعداد البيئة
• كيفية إدراج اللغات المتاحة
• كيفية ترجمة النصوص
• كيفية رصد اللغات

المتطلبات

• مشروع Google Cloud
• متصفّح، مثل Chrome أو Firefox
• الإلمام باستخدام لغة Python

استطلاع الرأي

كيف ستستخدم هذا البرنامج التعليمي؟

قراءة النص فقط قراءة النص وإكمال التمارين

كيف تقيّم تجربتك مع Python؟

مبتدئ متوسط متقن

كيف تقيّم تجربتك مع خدمات Google Cloud؟

مبتدئ متوسط متقدّم

2. الإعداد والمتطلبات

إعداد البيئة بالسرعة التي تناسبك

1. سجِّل الدخول إلى Google Cloud Console وأنشِئ مشروعًا جديدًا أو أعِد استخدام مشروع حالي. إذا لم يكن لديك حساب على Gmail أو Google Workspace، عليك إنشاء حساب.

• اسم المشروع هو الاسم المعروض للمشاركين في هذا المشروع. وهي سلسلة أحرف لا تستخدمها Google APIs. ويمكنك تعديلها في أي وقت.
• رقم تعريف المشروع هو معرّف فريد في جميع مشاريع Google Cloud ولا يمكن تغييره (لا يمكن تغييره بعد ضبطه). تنشئ Cloud Console سلسلة فريدة تلقائيًا، ولا يهمّك عادةً ما هي. في معظم دروس البرمجة، عليك الرجوع إلى رقم تعريف مشروعك (يُشار إليه عادةً باسم PROJECT_ID). إذا لم يعجبك رقم التعريف الذي تم إنشاؤه، يمكنك إنشاء رقم آخر عشوائي. يمكنك بدلاً من ذلك تجربة اسم مستخدم من اختيارك ومعرفة ما إذا كان متاحًا. لا يمكن تغيير هذا الخيار بعد هذه الخطوة ويظل ساريًا طوال مدة المشروع.
• للعلم، هناك قيمة ثالثة، وهي رقم المشروع، وتستخدمها بعض واجهات برمجة التطبيقات. يمكنك الاطّلاع على مزيد من المعلومات حول هذه القيم الثلاث في المستندات.

ملاحظة: رقم تعريف المشروع فريد على مستوى العالم ولا يمكن لأي شخص آخر استخدامه بعد اختياره. أنت المستخدم الوحيد لهذا المعرّف. حتى إذا تم حذف مشروع، لا يمكن استخدام المعرّف مرة أخرى.

ملاحظة: إذا كنت تستخدم حساب Gmail، يمكنك ترك الموقع الجغرافي التلقائي مضبوطًا على لا توجد مؤسسة. إذا كنت تستخدم حسابًا على Google Workspace، اختَر موقعًا جغرافيًا مناسبًا لمؤسستك.

2. بعد ذلك، عليك تفعيل الفوترة في Cloud Console لاستخدام موارد/واجهات برمجة تطبيقات Cloud. لن تكلفك تجربة هذا الدرس البرمجي الكثير، إن وُجدت أي تكلفة. لإيقاف الموارد وتجنُّب تحمّل تكاليف فوترة تتجاوز هذا البرنامج التعليمي، يمكنك حذف الموارد التي أنشأتها أو حذف المشروع. يمكن لمستخدمي Google Cloud الجدد الاستفادة من برنامج الفترة التجريبية المجانية بقيمة 300 دولار أمريكي.

بدء Cloud Shell

على الرغم من إمكانية تشغيل Google Cloud عن بُعد من الكمبيوتر المحمول، ستستخدم في هذا الدرس التطبيقي حول الترميز Cloud Shell، وهي بيئة سطر أوامر تعمل في السحابة الإلكترونية.

تفعيل Cloud Shell

1. من Cloud Console، انقر على تفعيل Cloud Shell .

إذا كانت هذه هي المرة الأولى التي تبدأ فيها Cloud Shell، ستظهر لك شاشة وسيطة توضّح ماهيتها. إذا ظهرت لك شاشة وسيطة، انقر على متابعة.

يستغرق توفير Cloud Shell والاتصال به بضع لحظات فقط.

يتم تحميل هذا الجهاز الافتراضي بجميع أدوات التطوير اللازمة. توفّر هذه الخدمة دليلًا منزليًا ثابتًا بسعة 5 غيغابايت وتعمل في Google Cloud، ما يؤدي إلى تحسين أداء الشبكة والمصادقة بشكل كبير. يمكن إنجاز معظم عملك في هذا الدرس البرمجي، إن لم يكن كله، باستخدام متصفّح.

بعد الاتصال بـ 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. ستلاحظ إمكانية إكمال علامات التبويب. قد يُطلب منك إثبات ملكية حسابك في المرة الأولى التي تنفّذ فيها أمرًا. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على أداة سطر أوامر 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- إعداد البيئة

قبل أن تتمكّن من بدء استخدام Translation API، شغِّل الأمر التالي في Cloud Shell لتفعيل الواجهة:

gcloud services enable translate.googleapis.com

ينبغي أن تظهر لك على النحو التالي:

Operation "operations/..." finished successfully.

يمكنك الآن استخدام Translation 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. عرض قائمة باللغات المتاحة

في هذا القسم، ستدرِج جميع اللغات المتاحة في Translation 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

يمكنك تجربة رمز لغة آخر.

ملخّص

في هذه الخطوة، تمكّنت من إدراج جميع اللغات المتاحة في Translation API. يمكنك العثور على القائمة الكاملة باللغات المتاحة في صفحة اللغات المتاحة.

5- ترجمة النص

يمكنك استخدام Translation API لترجمة النصوص من لغة إلى أخرى. تتم ترجمة النص باستخدام نموذج "الترجمة الآلية العصبية" (NMT). إذا كان نموذج "الترجمة الآلية العصبية" غير متاح للزوج اللغوي المطلوب ترجمته، سيتم استخدام نموذج "الترجمة الآلية المستندة إلى العبارات" (PBMT). لمزيد من المعلومات عن "ترجمة Google" ونماذج الترجمة، يُرجى الاطّلاع على مشاركة الإعلان عن الترجمة الآلية العصبية.

لترجمة نص، انسخ الرمز التالي والصقه في جلسة 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 : 안녕하세요!

ملخّص

في هذه الخطوة، تمكّنت من استخدام Translation API لترجمة النص إلى عدة لغات. مزيد من المعلومات حول ترجمة النص

6. اكتشاف اللغات

يمكنك أيضًا استخدام Translation 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    | 안녕하세요!

ملخّص

في هذه الخطوة، تمكّنت من رصد لغة جزء من النص باستخدام Translation API. مزيد من المعلومات حول رصد اللغات

7. تهانينا!

تعرّفت على كيفية استخدام Translation 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

مزيد من المعلومات

• مستندات Cloud Translation: ‏ 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 License.