يعرض لك هذا المشروع كيفية تنفيذ قطعة بسيطة من Glassware تعرض الوظائف الرئيسية لواجهة برمجة تطبيقات Google Mirror.
للاطلاع على عرض توضيحي كامل عن مشروع البدء السريع، انتقل إلى https://glass-python-starter-demo.appspot.com. وإلا، تابع القراءة لمعرفة كيفية نشر إصدارك الخاص.
المتطلبات الأساسية
حزمة تطوير البرامج (SDK) الخاصة بمحرك التطبيقات في Python - تم تنفيذ مشروع البدء السريع بلغة Python باستخدام App Engine. يجب استخدام حِزمة SDK لـ Python App Engine لتطوير مشروعك ونشره. شغِّل أداة التثبيت إذا كان ذلك مناسبًا للنظام الأساسي الذي تستخدمه، أو استخرج الملف المضغوط من مكان ملائم.
إنشاء مثيل Google App Engine
ستحتاج إلى استضافة مشروع البدء السريع على مثيل لـ Google App Engine:
- انتقل إلى http://appspot.com.
- انقر على إنشاء تطبيق وأنشئ مثيل Google App Engine عامًا مستضافًا على
appspot.com
. - امنح التطبيق معرّف التطبيق واترك المصادقة مفتوحة لجميع مستخدمي حسابات Google. ستحتاج إلى معرّف التطبيق لاحقًا لتهيئة مشروع البدء السريع.
إنشاء مشروع وحدة تحكم Google APIs
بعد ذلك، يجب تفعيل الوصول إلى Google Mirror API:
- انتقل إلى وحدة تحكم Google APIs وأنشئ مشروع واجهة برمجة تطبيقات جديدًا.
- انقر على الخدمات وفعِّل Google Mirror API لمشروعك الجديد.
- انقر على الوصول إلى واجهة برمجة التطبيقات وأنشئ معرِّف عميل OAuth 2.0 لتطبيق ويب.
- حدد اسم المنتج ورمزه لـ Glassware. تظهر هذه الحقول على شاشة منح OAuth الإذن المقدمة للمستخدمين.
- اختَر تطبيق ويب وحدِّد أي قيمة لاسم المضيف، مثل
localhost
- انقر على تعديل الإعدادات... لمعرِّف العميل لتحديد معرِّفات الموارد المنتظمة (URI) لإعادة التوجيه. حدِّد
http://localhost:8080/oauth2callback
وعنوان URL لرد الاتصال على مثيل App Engine، على سبيل المثال،https://myappengineinstance.appspot.com/oauth2callback
. - دوّن معرّف وسر العميل من وحدة تحكم Google APIs. ستحتاج إليه لإعداد مشروع البدء السريع.
تهيئة المشروع
اضبط مشروع البدء السريع لاستخدام معلومات عميل واجهة برمجة التطبيقات:
- أدخِل معرّف العميل والرمز السري في
client_secrets.json
:{ "web": { "client_id": "1234.apps.googleusercontent.com", "client_secret": "ITS_A_SECRET_TO_EVERYBODY", "redirect_uris": [ ], "auth_uri": "https://accounts.google.com/o/oauth2/auth", "token_uri": "https://accounts.google.com/o/oauth2/token" } }
- أنشئ ملف
session.secret
لتخزين ملفات تعريف ارتباط الجلسة:$ python -c "import os; print os.urandom(64)" > session.secret
- عدّل
app.yaml
لإدخال معرّف تطبيق App Engine:application: your_app_engine_application_id version: 1 runtime: python27 api_version: 1 threadsafe: true ...
نشر المشروع
اضغط على الزر نشر الأزرق في واجهة المستخدم التصويرية (GUI) لإطلاق App Engine أو شغّل أمر shell هذا لنشر الرمز:
$ appcfg.py --oauth2 update .