شراء حساب Google Cloud: Google Cloud (Google Cloud) ترجمة API من صفر إلى دليل التكوين والاتصال

عند التوطين في البحر ، أو عندما تكون منتجات التجارة الإلكترونية عبر الحدود على الرفوف بلغات متعددة ، أو عند إنشاء نظام خدمة عملاء متعدد الجنسيات ،

Google Cloud Translation API (Google Cloud Translation API)

بفضل تراكمها الضخم ، ودقة عالية للغاية متعددة اللغات ، وتأخير استجابة شبه ثانية ، أصبحت الخيار الأول لمعظم الفرق الفنية.

ومع ذلك ، بالنسبة للمطورين الذين اتصلوا بـ Google Cloud (GCP) لأول مرة ، فإن وحدة التحكم الضخمة الخاصة بهم ونظام أذونات IAM المعقد وشهادات المصادقة المختلفة (حسابات الخدمة) غالبًا ما تجعل الناس يشعرون بالدوار.

هذه المقالة سوف تتخلى عن جميع الوثائق الرسمية

أنقى وجهة نظر حقيقية للمبرمجين

، لا تدور حول الانحناء ، خذ يدك لإكمال من

فتح الخدمات ، وتكوين الأذونات ، وإنشاء القسائم ، واستدعاء الكود المحلي النهائي

العملية الكاملة.

1. المفهوم الأساسي: اختر إصدار API الذي يناسب عملك

قبل التكوين الرسمي ، يجب عليك معرفة الإصدارين الأساسيين من واجهة برمجة تطبيقات الترجمة السحابية من Google ، والتي تحدد الواجهة وطريقة الفوترة التي ستتصل بها لاحقًا:

Cloud Translation Basic (v2): الميزات: بسيطة ، مباشرة ، خارج الصندوق. سيناريوهات قابلة للتطبيق: ترجمة النص الأكثر شيوعًا ، ترجمة صفحة الويب. تحتاج فقط إلى إلقاء جزء من النص على واجهة برمجة التطبيقات ، وسوف يكتشف اللغة تلقائيا ويعيد نتائج الترجمة. يدعم الاتصال باستخدام حساب API Key أو خدمة بسيط.

Cloud Translation Advanced (v3): الميزات: مستوى المؤسسة ، درجة عالية من التهيئة. سيناريوهات قابلة للتطبيق: تحتاج إلى استخدام Glossaries (على سبيل المثال: أسماء علامة تجارية محددة ، أو لا تريد ترجمة المفردات المهنية في الصناعة بالقوة) ، أو تحتاج إلى تحديد نماذج ترجمة مخصصة في مجال معين. يجب أن تستخدم حساب الخدمة (حساب الخدمة) لمصادقة OAuth2.

نصيحة عملية: إذا لم يكن لعملك متطلبات صارمة لمصطلحات الصناعة المهنية للغاية ، فمن المستحسن بشدة البدء في التكوين من v2 (Basic) ، فإن تكلفة التطوير والإرساء هي الأدنى ، ويمكن أن تلبي بالكامل أكثر من 95 ٪ من احتياجات الترجمة اليومية.

الخطوة الأولى: إنشاء مشروع وتفعيل خدمات API

يبدأ أساس جميع عمليات GCP بـ "المشروع". إذا لم يكن لديك حساب Google Cloud حتى الآن ، يرجى التسجيل وربط بطاقة ائتمان تسوية (عادةً ما يكون لدى المستخدمين الجدد حد مجاني قدره 300 دولار).

1-إنشاء أو اختيار المشاريع

قم بتسجيل الدخول إلى Google Cloud Console (Google Cloud Console).

انقر على العنصر في الزاوية العلوية اليسرى لتحديد المربع المنسدل ، وانقر على "مشروع جديد" (مشروع جديد).

شراء حساب سحابة جوجل

أدخل اسم المشروع (على سبيل المثال: my-translation-service) ، واختر مؤسستك ، وانقر على إنشاء.

2. تمكين Translation API

أدخل: "Cloud Translation API" في شريط البحث أعلى وحدة التحكم.

في نتائج البحث ، انقر على الدخول إلى صفحة المنتج.

تأكد من تحديد العنصر الذي قمت بإنشائه للتو في الزاوية العلوية اليسرى ، ثم اضغط على الزر "تمكين" الأزرق. ملاحظة: إذا طُلب منك ربط حساب التسوية الخاص بك ، فاتبع التعليمات لإكمال ربط بطاقة الائتمان ، وإلا فلن تتمكن من تنشيط واجهة برمجة التطبيقات.

3. الخطوة الثانية: تكوين شهادة المصادقة (نقطة تجنب حرجة)

من أجل ضمان الأمان ، لا تشجع Google Cloud على فضح مفتاح API العام في بيئة الإنتاج. من أجل استدعاء الواجهة ، نحتاج إلى إنشاء شهادة تصديق مناسبة. يتم تقديم اثنين من أكثر طرق التكوين شيوعًا هنا.

الطريقة أ: استخدام مفتاح API (مفتاح API)-مناسب للتطوير السريع واختبار v2

إذا اخترت إصدار v2 واستدعت فقط بين الخوادم الخلفية ، فإن استخدام API Key هو أسرع طريقة.

في شريط التنقل على الجانب الأيسر من وحدة التحكم ، أدخل "API & Services" (APIs & Services) -> "بيانات الاعتماد" (Credentials).

انقر فوق "إنشاء بيانات الاعتماد" (CREATE CREDENTIALS) في الجزء العلوي من الصفحة ، واختر "مفتاح API".

ستظهر نافذة تظهر سلسلة من السلاسل مثل AIzaSy... هذا هو مفتاح API الخاص بك. نسخ والاحتفاظ بها بشكل صحيح.

⚠تحذير عالي الخطورة (يجب أن يكون التكوين): لا توجد قيود على واجهة برمجة التطبيقات التي تم إنشاؤها للتو. إذا تم اختراقها وسرقتها ، فسوف تنفجر بطاقة الائتمان الخاصة بك على الفور. انقر على "تعديل (رمز قلم رصاص)" على الجانب الأيمن من هذا المفتاح. في وحدة "قيود API" ، حدد "مفتاح التقييد". في القائمة المنسدلة ، حدد "Cloud Translation API". حفظ. بهذه الطريقة ، حتى لو تم تسريب هذا المفتاح ، فلا يمكن استخدامه إلا للاتصال بخدمات الترجمة ، ولا يمكن استخدامه لفتح خادم سحابة عالي الجودة للتعدين.

الطريقة B: استخدام حساب الخدمة-مواصفات بيئة الإنتاج (دعم v2 و v3)

شراء حساب جوجل كلاود

بالنسبة للمشاريع الرسمية التي يتم إطلاقها عبر الإنترنت ، فإن استخدام حسابات الخدمة لإنشاء مستندات قسيمة JSON هو ممارسة قياسية موصى بها رسميًا من قبل Google.

أيضًا في صفحة "بيانات الاعتماد" ، انقر فوق "إنشاء بيانات اعتماد" ، وهذه المرة حدد "حساب الخدمة" (حساب الخدمة).

أدخل اسم حساب الخدمة (على سبيل المثال: الترجمة-user) ، وانقر على "إنشاء ومواصلة".

تخصيص الأذونات (المفتاح): في المربع المنسدل "الدور" ، ابحث عن "Cloud Translation -> Clou" واختر

D Translation API "(Cloud Translation API User). هذا الدور لديه الحد الأدنى من الأذونات اللازمة لاستدعاء واجهة الترجمة.

انقر على الاستمرار والانتهاء.

ارجع إلى صفحة قائمة بيانات الاعتماد ، وابحث عن الحساب الذي تم إنشاؤه للتو في قائمة "حسابات الخدمة" أدناه ، وانقر على "مفاتيح الإدارة" على اليمين.

انقر فوق "إضافة مفتاح" (ADD KEY) -> "إنشاء مفتاح جديد" ، حدد النوع JSON.

بعد النقر على إنشاء ، يقوم المتصفح تلقائيًا بتنزيل ملف يسمى xxxx-uuid.json. هذا الملف هو مفتاحك الخاص ، ويجب عدم تحميله على منصات عامة مثل GitHub!

4. الخطوة الثالثة: التطوير المحلي وتنفيذ التعليمات البرمجية (هبوط متعدد اللغات)

بعد الحصول على القسيمة ، يمكننا كتابة الكود محليًا لتصحيح الأخطاء. يتم إعطاء ما يلي بشكل منفصل على أساس

API Key

أبسط طريقة طلب HTTP ، وكذلك على أساس

قسيمة JSON

يتم تنفيذ اللغة السائدة على مستوى الإنتاج SDK.

1. تدفق الحد الأدنى: طلب HTTP POST باستخدام API Key

إذا كنت لا ترغب في تثبيت أي SDK ، استخدم مباشرة

Caler

أو عميل HTTP شائع الاستخدام (مثل Axios ، Postman) يمكنه استدعاء واجهة v2.

طلب عنوان URL:https://translation.googleapis.com/language/translate/v2

طريقة الطلب: POST

معلمات الاستعلام: key = API_KEY الخاص بك

Request Body (JSON):

JSON

{

"Q": ["Hello world! "،" كيف أنت ؟ "] ،

"Target": "zh-CN"

}

إرجاع النتيجة (Response):

JSON

{

"البيانات": {

"الترجمة": [

{

"TranslatedText": "مرحبا ، العالم! "،

"DetectedSourceLanguage": "en"

} ،

{

"TranslatedText": "كيف حالك اليوم ؟ "،

"DetectedSourceLanguage": "en"

}

]

}

}

2. تدفق الإنتاج: استخدام قسائم JSON لحساب الخدمة (خذ Node.js و Python كأمثلة)

في الاستخدام الرسمي

قبل SDK ، تحتاج إلى تكوين متغير بيئة في بيئة التشغيل المحلية أو الخادم الخاص بك لإخبار SDK أين يتم وضع بيانات اعتماد JSON الخاصة بك.

أمر تكوين Linux/macOS: Bashexport GOOGLE_APPLICATION_CREDENTIALS = "/path/to/your/google-credentials.json"

Windows (PowerShell) أمر التكوين: PowerShell $ env:GOOGLE_APPLICATION_CREDENTIALS = "C:\ path \ to \ your \ google-credentials.json"

🐍كود التشغيل الفعلي Python (v2)

قم أولاً بتثبيت مكتبة التبعية الرسمية:

شراء حساب جوجل كلاود

باش

Pip install google-cloud-translate = 2.0.1

كتابة وتشغيل البرامج النصية:

بايثون

From google.cloud import translate_v2 as translate

Def translate_text(text ، target_language = "zh-CN"):

# SDK يقرأ تلقائيًا بيانات اعتماد JSON في متغير البيئة

Translate_client = translate.Client()

# إذا كانت القائمة الواردة ، ودعم الترجمة المجمعة

If isinstance(text, bytes):

Text = text.de code("utf-8")

Result = translate_client.translate(text, target_language = target_language)

Print (f "النص الأصلي: {result['input']}")

Print (f "ترجمة النتيجة: {result['translatedText']}")

Print (f "لغة مصدر تم الكشف عنها: {result['detectedSourceLanguage']")

If __name__ = = "__main__":

Translate_text ("Boost your productivity مع Google Cloud! "، تا

Rget_language = "zh-CN")

🟢Node.js التعليمات البرمجية العملية (v2)

أولاً، قم بتثبيت مكتبة التبعيات الرسمية:

باش

Npm install @ google-cloud/translate

كتابة التعليمات البرمجية وتشغيلها:

جافاسكريبت

Const {Translate} = require ("@ google-cloud/translate").v2 ؛

// عميل مثيل ، SDK يبحث تلقائيًا عن بيانات الاعتماد من متغيرات البيئة

الترجمة const = الترجمة الجديدة () ؛

Async function quickStart() {

Text = 'Hello, international expansion! '؛

Target const = 'zh-CN' ؛ // اللغة المستهدفة: الصينية المبسطة

جرّب {

Const [translation] = await translate.translate(text ، target) ؛

Console. log('Text: ${text}') ؛

Console. log('الترجمة: ${translation}') ؛

} باستثناء (خطأ) {

Console. error('الترجمة الخاطئة:' ، error) ؛

}

}

QuickStart () ؛

5. دليل التحكم في التكاليف وتجنب النواة الصلبة

واجهة برمجة تطبيقات Google Cloud Translation ليست مجانية ، وطريقة الفوترة هي

الفواتير حسب عدد الأحرف (Characters)

، بما في ذلك المسافات. إذا لم يتم التحكم فيه ، فإن التزامن الخبيث من قبل المستخدمين في الواجهة الأمامية أو استدعاء الحلقة الميتة على مستوى الكود سيؤدي إلى فواتير اقتصادية ثقيلة للمؤسسة.

1-تسوية حسابات الأسعار (أسعار v2 كمثال)

كل شهر فاتورة ، ستقدم Google Cloud مبلغًا مجانيًا قدره 500000 حرف (500000 حرف). يكفي لاختبار صغير الحجم أو مدونة شخصية.

بعد تجاوز الحد المجاني ، يكون السعر 20 دولارًا أمريكيًا/مليون حرف (Million characters).

العداد التجنب: عند ترجمة نص غني يحتوي على عدد كبير من علامات HTML ، سيتم أيضًا احتساب علامة HTML نفسها (مثل <p> ، <div> ، class = "xxx") على أنها فواتير أحرف. لذلك ، قبل إرسال النص إلى واجهة برمجة التطبيقات ، من الأفضل تجريد علامات HTML على مستوى الكود ، وإعادة تجميعها بعد ترجمة النص العادي ، وهذا

يمكن أن توفر لك 30 ٪ ~ فاتورة ضخمة بنسبة 50 ٪.

2. تكوين "حد الانصهار" في وحدة التحكم

من أجل منع الفواتير باهظة الثمن بسبب الحلقة الميتة للرمز أو هجمات القرصنة ، يجب إغلاق الحد الأعلى للاستدعاء في اليوم الأول.

انتقل إلى "API والخدمات"-> "API والخدمات التي تم تمكينها" في وحدة تحكم GCP وابحث عن واجهة برمجة تطبيقات Cloud Translation.

بعد النقر على الدخول ، انتقل إلى علامة التبويب "الحصص وحدود النظام" (Quotas & System Limits).

ابحث عن "عدد الاستفسارات في الدقيقة" و "الحد اليومي لعدد الأحرف".

انقر على التعديل لتقييده ضمن نطاق معقول من تقديرات عملك (على سبيل المثال: استدعاء ما يصل إلى 200000 حرف في اليوم). بمجرد تجاوزها ، ستعود واجهة برمجة التطبيقات مباشرة إلى 429 Too Many Requests للإبلاغ عن الأخطاء ، وبالتالي قفل حد إنفاق بطاقة الائتمان الخاصة بك.

3. بناء طبقة ذاكرة التخزين المؤقت المحلية (Cache)

تتمتع أعمال الترجمة بخاصية طبيعية: معدل تكرار الكلمات عالية التردد ونمط الجملة الثابت مرتفع للغاية.

شراء حساب جوجل كلاود

تحسين الهندسة المعمارية: قم ببناء طبقة ذاكرة التخزين المؤقت البسيطة على الخادم الخلفي الخاص بك (مثل استخدام Redis). في كل مرة قبل استدعاء الواجهة ، انتقل إلى Redis للتحقق مما إذا كان هناك ذاكرة تخزين مؤقت لهدف الترجمة يتوافق مع النص (على سبيل المثال: MD5 (اللغة الأصلية المستهدفة) كمفتاح).

إذا كان الأمر كذلك ، فإن قراءة ذاكرة التخزين المؤقت مباشرة تستغرق 1 مللي ثانية وتكلفة 0 ؛ إذا لم يكن الأمر كذلك ، فاتصل بـ Google API ثم اكتب النتيجة في Redis. يمكن لهذه الخطوة البسيطة أن تقطع مباشرة أكثر من 60 ٪ من نفقات واجهة برمجة التطبيقات للتطبيقات الناضجة.

سادساً، الخلاصة

إن السياق الأساسي لتكوين واجهة برمجة تطبيقات الترجمة السحابية من Google واضح جدًا في الواقع:

مشروع البناء-> فتح الخدمة-> الحصول على قسيمة (سلطة تقييد)-> للتغير البيئي-> تعيين بطاقة محدودة مقاومة للانفجار

.

بالنسبة للأعمال التجارية اليومية التي تذهب إلى البحر ، ضع في اعتبارك "مبدأ الحد الأدنى من الأذونات" لاستخدام حساب الخدمة (حساب الخدمة) ، ومطابقة ذاكرة التخزين المؤقت الخلفية Redis وسقف الحصة على جانب GCP ، يمكنك الحصول على مجموعة مستقرة وعالية الإنتاجية وميزانية يمكن التحكم فيها بالكامل. البنية التحتية للترجمة متعددة اللغات.