התחלה מהירה ב-Python

הפרויקט הזה מראה איך להטמיע חלקים פשוטים של Glassware שמדגימים את הפונקציונליות העיקרית של Google Mirror API.

לצפייה בהדגמה המלאה של פרויקט ההתחלה המהירה, היכנסו לכתובת https://glass-python-starter-demo.appspot.com. אחרת, קראו איך לפרוס את הגרסה שלכם.

הורדה ב-GitHub

דרישות מוקדמות

App Engine SDK ל-Python – פרויקט Python למתחילים מופעל ב-App Engine. צריך את Python App Engine SDK כדי לפתח ולפרוס את הפרויקט. הפעילו את מנהל ההתקנה אם הוא מתאים לפלטפורמה שלכם, או חלצו את קובץ ה-ZIP במקום נוח.

יצירת מופע של Google App Engine

יהיה עליך לארח את פרויקט ההפעלה המהירה במופע של Google App Engine:

  1. נכנסים אל http://appspot.com.
  2. לוחצים על Create Application ויוצרים מכונה ציבורית של Google App Engine שמתארחת ב-appspot.com.
  3. נותנים לאפליקציה מזהה אפליקציה ומשאירים את האימות פתוח לכל המשתמשים בחשבונות Google. מאוחר יותר תצטרך את מזהה האפליקציה כדי להגדיר את הפרויקט להתחלה מהירה.

יצירת פרויקט ב-Google APIs Console

בשלב הבא, מעניקים גישה ל-Google Mirror API:

  1. נכנסים למסוף Google APIs ויוצרים פרויקט API חדש.
  2. לוחצים על Services (שירותים) ומפעילים את Google שיקוף API בפרויקט החדש. ממשק ה-API של Google שיקוף במסוף Google API
  3. לוחצים על גישה ל-API ויוצרים מזהה לקוח OAuth 2.0 עבור אפליקציית אינטרנט. בקטע 'גישת API' במסוף Google API
  4. יש לציין את השם והסמל של המוצר ב-Glassware. השדות האלה מופיעים במסך המענק של OAuth שמוצג למשתמשים. ציון פרטי המותג
  5. בוחרים באפשרות אפליקציית אינטרנט ומציינים ערך עבור שם המארח, למשל localhost בחירת סוג האפליקציה
  6. לחץ על ערוך הגדרות... עבור מזהה הלקוח כדי לציין מזהי URI של הפניה מחדש. ציינו את http://localhost:8080/oauth2callback ואת כתובת ה-URL לקריאה חוזרת של האירוע ב-App Engine, למשל https://myappengineinstance.appspot.com/oauth2callback. חלונית התצורה של מסוף Google API למזהי URI של הפניה מחדש
  7. רושמים את מספר הלקוח והסוד שלו ב-Google APIs Console. תצטרכו אותו כדי להגדיר את הפרויקט להתחלה מהירה. מזהה וסוד הלקוח במסוף Google API

הגדרת הפרויקט

מגדירים את הפרויקט ב'התחלה מהירה' כדי להשתמש בפרטי לקוח ה-API:

  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 לאחסון קובצי cookie לסשן:
    $ 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 או מריצים את פקודת המעטפת הזו כדי לפרוס את הקוד:

$ appcfg.py --oauth2 update .