1. قبل البدء
يعرض لك هذا الدرس التطبيقي كيفية إنشاء مشروع على Google Cloud ثم طلب Google Cloud APIs من ذلك المشروع.
المتطلبات الأساسية
- إمكانية التنقّل في Google Cloud Console.
ما ستتعرَّف عليه
- كيفية إنشاء مشروع على Google Cloud
- كيفية إعداد حساب فوترة
- كيفية إعداد Cloud Shell
- كيفية تفعيل واجهة برمجة التطبيقات
- كيفية تفويض واجهة برمجة تطبيقات باستخدام مفتاح واجهة برمجة التطبيقات
- كيفية تفويض واجهة برمجة تطبيقات باستخدام حساب خدمة
المتطلبات
- حساب Google، مثل حساب Gmail أو حساب Google Workspace
- إمكانية الوصول إلى حساب فوترة Cloud أو بطاقة ائتمان لاستخدامها في الاشتراك في برنامج الفترة التجريبية المجانية
2. الإعداد
يوضِّح لك هذا القسم كيفية إنشاء مشروع على Google Cloud وإعداد حساب فوترة وإعداد Cloud Shell.
إنشاء مشروع على Google Cloud وإعداد حساب فوترة
- سجِّل الدخول إلى Cloud Console واختَر مشروعًا أو أنشئه.
تذكّر رقم تعريف المشروع الذي يظهر ضمن حقل اسم المشروع. رقم التعريف هو اسم فريد في جميع مشاريع Google Cloud (سبق أن تم استخدام هذا الاسم)، ويُشار إليه لاحقًا في هذا الدرس التطبيقي حول الترميز باسم PROJECT_ID.
- بعد ذلك، يمكنك تفعيل الفوترة في Cloud Console لاستخدام موارد Google Cloud.
على الرغم من أنّ هذا الدرس التطبيقي حول الترميز لن يكلّف الكثير، إن وجد، اتّبِع التعليمات الواردة في القسم تنظيف لإيقاف الموارد وتجنُّب التكاليف التي تتجاوز هذا الدرس التطبيقي. لاحظ أن مستخدمي Google Cloud الجدد مؤهّلون للحصول على فترة تجريبية مجانية بقيمة 300 دولار أمريكي.
إعداد Cloud Shell
في هذا الدرس التطبيقي حول الترميز، يمكنك استخدام Cloud Shell، وهي بيئة سطر أوامر يتم تشغيلها في Google Cloud. Cloud Shell عبارة عن جهاز افتراضي يستند إلى Debian ويتضمّن جميع أدوات التطوير التي تحتاج إليها. ويوفّر هذا الدليل دليلاً رئيسيًا ثابتًا بسعة 5 غيغابايت، ما يحسّن أداء الشبكة والمصادقة بشكل كبير. وهذا يعني أنّ كل ما تحتاج إليه لإكمال هذا الدرس التطبيقي هو متصفّح.
لتفعيل Cloud Shell من Cloud Console:
- انقر على
تفعيل Cloud Shell.
قد تستغرق إدارة الحسابات والاتصال بالبيئة بضع لحظات.
بعد الربط بخدمة Cloud Shell، من المفترض أن يظهر لك أنّه قد تمت مصادقتك وأنّ المشروع سبق أن تم ضبطه على PROJECT_ID.
- إنشاء قائمة بالحسابات المعتمَدة:
gcloud auth list
من المفترض أن يظهر لك هذا الإخراج:
Credentialed accounts:
- <MY_ACCOUNT>@<MY_DOMAIN>.com (active)
- للاطّلاع على قائمة بمشاريعك، أدخِل هذا الأمر.
gcloud config list project
من المفترض أن يظهر لك هذا الإخراج:
[core]
project = <PROJECT_ID>
إذا لم يتم ضبط المشروع لسبب ما، شغِّل هذا الأمر لإعداده.
gcloud config set project <PROJECT_ID>
وPROJECT_ID هو رقم التعريف الذي استخدمته في خطوات الإعداد. يمكنك أيضًا البحث عنه في لوحة بيانات Cloud Console:
تضبط Cloud Shell أيضًا بعض متغيرات البيئة تلقائيًا، وهو ما قد يكون مفيدًا عند تشغيل الأوامر المستقبلية.
- للاطّلاع على رقم تعريف مشروعك، أدخِل الأمر التالي.
echo $GOOGLE_CLOUD_PROJECT
من المفترض أن يظهر لك الناتج التالي:
<PROJECT_ID>
- أخيرًا، قم بتعيين تهيئة المنطقة الافتراضية والمشروع.
gcloud config set compute/zone us-central1-f
يمكنك اختيار مجموعة متنوعة من المناطق المختلفة. لمزيد من المعلومات، يُرجى الاطّلاع على المناطق.
3- طلب واجهة برمجة تطبيقات من مشروع
يعرض لك هذا الدرس التطبيقي كيفية استخدام نموذج لواجهة برمجة تطبيقات (Natual Language API) للعثور على الكيانات (مثل الأشخاص والأماكن والأحداث) في نصّها، وكيفية تقريب شعور (مستوى الأفضلية) لهذا النص. وستتعرف على كيفية:
- تفعيل واجهات Google Cloud API
- احصل على تفويض لواجهة برمجة التطبيقات باستخدام مفاتيح واجهة برمجة التطبيقات وحسابات الخدمة.
- يمكنك استدعاء واجهة برمجة التطبيقات مع
curlومكتبات العملاء.
تفعيل واجهة برمجة تطبيقات
- حدد واجهات برمجة التطبيقات الخدمات من القائمة الرئيسية في Cloud Console.
- اختَر + تفعيل واجهات برمجة التطبيقات والخدمات من أعلى الشاشة.
- في هذه المرحلة، يمكنك فلترة واجهات برمجة التطبيقات وتصفّحها أو الانتقال مباشرةً إلى إحدى واجهات برمجة التطبيقات باستخدام المربّع البحث. ابحث عن
Natural Languageواختَر Cloud Natural Language API.
- انقر على تجربة واجهة برمجة التطبيقات هذه.
إذا لم يظهر الزر تجربة واجهة برمجة التطبيقات هذه، انقر على إحدى الطرق المدرَجة لتجربة هذه الطريقة.
إنشاء مفتاح واجهة برمجة التطبيقات
بما أنّك تستخدم curl لإرسال طلب إلى Natural Language API، يجب إنشاء مفتاح واجهة برمجة تطبيقات لتمرير عنوان URL الخاص بطلبك.
- في Cloud Console، حدِّد قائمة التنقل > واجهات برمجة التطبيقات الخدمات > بيانات الاعتماد:
- انقر على إنشاء شهادات ثم اختَر مفتاح واجهة برمجة التطبيقات:
- انسخ مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه، ثم انقر على إغلاق.
استخدام مفتاح واجهة برمجة التطبيقات لطلب بيانات من واجهة برمجة التطبيقات
- في سطر أوامر Cloud Shell، صدِّر مفتاح واجهة برمجة التطبيقات.
export API_KEY=<YOUR_API_KEY>
استبدِل <YOUR_API_KEY> بالمفتاح الذي أنشأته سابقًا.
- أنشئ طلبًا لواجهة برمجة التطبيقات في "محرِّر Cloud Shell" أو باستخدام محرِّر في Linux، مثل Vim أو Emacs. يمكنك العثور على تفاصيل المَعلمات في Method: Docs.analyzeContacts. احفظ المخرجات في ملف باسم
request.json:
{
"document":{
"type":"PLAIN_TEXT",
"content":"Google, headquartered in Mountain View (1600 Amphitheatre Pkwy, Mountain View, CA 940430), unveiled the new Android phone for $799 at the Consumer Electronic Show. Sundar Pichai said in his keynote that users love their new Android phones."
},
"encodingType":"UTF8"
}
- يمكنك استدعاء واجهة برمجة التطبيقات مع تقديم معلومات الطلب.
curl "https://language.googleapis.com/v1/documents:analyzeEntities?key=${API_KEY}" \
-s -X POST -H "Content-Type: application/json" --data-binary @request.json
- إعادة تشغيل الأمر وإعادة توجيه الناتج إلى ملف وفحص النتيجة. تتوفر أيضًا تفاصيل نتائج ملف JSON في الطريقة: Docs.analyzeEntity.
- لتغيير النص المراد تحليله في الملف
request.json، استبدِل القيمةcontentبالنص الذي تختاره.
4. التفويض باستخدام حساب الخدمة
غالبًا ما يتم تفضيل حسابات الخدمة على مفاتيح واجهة برمجة التطبيقات لأنها توفر كل من المصادقة والترخيص. يمكنك اعتبار حسابات الخدمة عناوين بريد إلكتروني لتطبيقك.
- ارجع إلى قسم بيانات الاعتماد في واجهات برمجة التطبيقات الخدمات.
- اختَر إنشاء بيانات اعتماد، ولكن هذه المرة، اختَر حساب الخدمة.
- أدخِل اسم حساب الخدمة الذي يصف الغرض منه، مثل "
Natural Language Service Account". يقترح النظام معرّفًا. يمكنك أيضًا إضافة وصف. عندما تتعرّف على المزيد من المعلومات عن حسابات الخدمة، ستُتيح إذن الوصول إلى حساب الخدمة للمشاريع وتمنح المستخدمين إذن الوصول إلى حساب الخدمة، ولكن في الوقت الحالي، ما عليك سوى النقر على تم لإنشاء حساب الخدمة. - لإنشاء مفتاحَي تشفير لحساب الخدمة من أجل استخدامه، انقر على
لتعديل حساب الخدمة.
يتم عرض تفاصيل حساب الخدمة.
- انسخ عنوان البريد الإلكتروني لحساب الخدمة وارجع إلى Cloud Shell.
- في Cloud Shell، أنشئ مفتاحَي تشفير لحساب الخدمة واضبط متغيّر بيئة للإشارة إليه:
gcloud iam service-accounts keys create ~/key.json \
--iam-account <your service account email>
export GOOGLE_APPLICATION_CREDENTIALS="/home/$USER/key.json"
تستخدم Google Cloud متغيّر البيئة هذا للعثور على بيانات الاعتماد، لذا لا حاجة إلى تضمينها في طلب بيانات من واجهة برمجة التطبيقات.
- يمكنك الآن طلب واجهة برمجة التطبيقات باستخدام الأمر:
gcloud ml language analyze-entities --content="Michelangelo Caravaggio, Italian painter, is known for 'The Calling of Saint Matthew'."
يجب أن تكون النتيجة هي نفسها كما في السابق.
تحتوي العديد من واجهات برمجة التطبيقات على مكتبات عملاء واسعة لاستخراج هذه التفاصيل منها. لمزيد من المعلومات عن مكتبات العملاء، يُرجى الاطّلاع على مكتبات عميل Cloud. يمكنك أيضًا قراءة وثائق واجهات برمجة التطبيقات التي تستخدمها لمعرفة مكتبات العملاء المتوفرة لها.
5- تَنظيم
من الممارسات السيئة استخدام مفتاح واجهة برمجة تطبيقات غير مقيّد للمشاريع. فإذا تمكن شخص ما من الوصول إلى هذا الملف الشخصي، يمكن لهذا الشخص استخدامه بدون الحاجة إلى المصادقة الإضافية.
لحذف مفتاح واجهة برمجة التطبيقات هذا:
- انقر على
قائمة التنقل > واجهات برمجة التطبيقات و الخدمات > بيانات الاعتماد: - ضمن مفاتيح واجهة برمجة التطبيقات، اختَر المفتاح الذي تريد حذفه ثم انقر على
حذف. - وبالمثل، بدلاً من القلق بشأن عدم حماية المفتاح الخاص لحساب الخدمة، ضمن حسابات الخدمة، اختَر حساب الخدمة المراد حذفه، ثم انقر على حذف.
6- تهانينا
تهانينا! لقد تعلمت كيفية إنشاء مشروع على Google Cloud وكيفية طلب واجهة برمجة تطبيقات من داخل المشروع.