البدء السريع للغة Python

يعرض لك هذا المشروع كيفية تنفيذ قطعة بسيطة من Glassware تعرض الوظائف الرئيسية لواجهة برمجة تطبيقات Google Mirror.

للاطلاع على عرض توضيحي كامل عن مشروع البدء السريع، انتقل إلى https://glass-python-starter-demo.appspot.com. وإلا، تابع القراءة لمعرفة كيفية نشر إصدارك الخاص.

التنزيل على GitHub

المتطلبات الأساسية

حزمة تطوير البرامج (SDK) الخاصة بمحرك التطبيقات في Python - تم تنفيذ مشروع البدء السريع بلغة Python باستخدام App Engine. يجب استخدام حِزمة SDK لـ Python App Engine لتطوير مشروعك ونشره. شغِّل أداة التثبيت إذا كان ذلك مناسبًا للنظام الأساسي الذي تستخدمه، أو استخرج الملف المضغوط من مكان ملائم.

إنشاء مثيل Google App Engine

ستحتاج إلى استضافة مشروع البدء السريع على مثيل لـ Google App Engine:

  1. انتقل إلى http://appspot.com.
  2. انقر على إنشاء تطبيق وأنشئ مثيل Google App Engine عامًا مستضافًا على appspot.com.
  3. امنح التطبيق معرّف التطبيق واترك المصادقة مفتوحة لجميع مستخدمي حسابات Google. ستحتاج إلى معرّف التطبيق لاحقًا لتهيئة مشروع البدء السريع.

إنشاء مشروع وحدة تحكم Google APIs

بعد ذلك، يجب تفعيل الوصول إلى Google Mirror API:

  1. انتقل إلى وحدة تحكم Google APIs وأنشئ مشروع واجهة برمجة تطبيقات جديدًا.
  2. انقر على الخدمات وفعِّل Google Mirror API لمشروعك الجديد. واجهة برمجة تطبيقات Google Mirror على وحدة تحكم واجهة برمجة تطبيقات Google
  3. انقر على الوصول إلى واجهة برمجة التطبيقات وأنشئ معرِّف عميل OAuth 2.0 لتطبيق ويب. قسم الوصول إلى واجهة برمجة التطبيقات في وحدة تحكم واجهة برمجة تطبيقات Google
  4. حدد اسم المنتج ورمزه لـ Glassware. تظهر هذه الحقول على شاشة منح OAuth الإذن المقدمة للمستخدمين. تحديد معلومات العلامة التجارية
  5. اختَر تطبيق ويب وحدِّد أي قيمة لاسم المضيف، مثل localhost اختيار نوع التطبيق
  6. انقر على تعديل الإعدادات... لمعرِّف العميل لتحديد معرِّفات الموارد المنتظمة (URI) لإعادة التوجيه. حدِّد http://localhost:8080/oauth2callback وعنوان URL لرد الاتصال على مثيل App Engine، على سبيل المثال، https://myappengineinstance.appspot.com/oauth2callback. لوحة تهيئة وحدة تحكم واجهة برمجة تطبيقات Google لعناوين URL لإعادة التوجيه
  7. دوّن معرّف وسر العميل من وحدة تحكم Google APIs. ستحتاج إليه لإعداد مشروع البدء السريع. معرّف وسر العميل في وحدة تحكم واجهة برمجة تطبيقات Google

تهيئة المشروع

اضبط مشروع البدء السريع لاستخدام معلومات عميل واجهة برمجة التطبيقات:

  1. أدخِل معرّف العميل والرمز السري في 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"
  }
}
  2. أنشئ ملف session.secret لتخزين ملفات تعريف ارتباط الجلسة: 
    $ python -c "import os; print os.urandom(64)" > session.secret
  3. عدّل 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 .