Python 快速入門

本專案會說明如何 展示 Google Mirror API 主要功能的 Glassware。

如要查看快速入門專案的完整示範,請前往 https://glass-python-starter-demo.appspot.com. 否則,請繼續閱讀,瞭解如何部署自己的版本。

前往 GitHub 下載

必要條件

Python 適用的 App Engine SDK: Python 快速入門專案是使用 App Engine 實作。您需要具備 Python App Engine SDK 來建立及部署您的專案。 視平臺情況執行安裝程式,或將 ZIP 檔案解壓縮 。

建立 Google App Engine 執行個體

您必須在 Google App Engine 執行個體上託管快速入門專案:

  1. 前往 http://appspot.com
  2. 按一下「Create Application」,建立在 appspot.com 託管的公開 Google App Engine 執行個體。
  3. 為應用程式提供應用程式識別碼並保持驗證對所有 Google 服務開放 帳戶使用者。您稍後需要應用程式 ID 才能設定快速入門專案。

建立 Google API 控制台專案

接著,啟用 Google Mirror API 的存取權:

  1. 前往 Google API 控制台,建立新的 API 專案。
  2. 按一下「服務」,然後為新專案啟用 Google Mirror API。 Google API 控制台的 Google Mirror API
  3. 按一下「API Access」(API 存取權),然後為網頁應用程式建立 OAuth 2.0 用戶端 ID。 Google API 控制台的 API 存取權部分
  4. 指定 Glassware 的產品名稱和圖示。這些欄位會顯示在 OAuth 授權中 向使用者顯示的螢幕畫面 指定品牌資訊
  5. 選取「網頁應用程式」,並指定主機名稱的任何值,例如 localhost 選取應用程式類型
  6. 按一下用戶端 ID 的 [Edit settings...],指定重新導向 URI。請說明 http://localhost:8080/oauth2callback 和 App Engine 的回呼網址 例如 https://myappengineinstance.appspot.com/oauth2callback 針對重新導向 URI 設定 Google API 控制台設定面板
  7. 記下 Google API 控制台中的用戶端 ID 和密鑰。你需要準備 來設定快速入門專案 Google API 控制台上的用戶端 ID 和密鑰

設定專案

設定快速入門專案,以便使用 API 用戶端資訊:

  1. client_secrets.json 中輸入用戶端 ID 與密鑰:
    {
      "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 應用程式 ID:
    application: your_app_engine_application_id
    version: 1
    runtime: python27
    api_version: 1
    threadsafe: true
    ...

部署專案

在 App Engine 啟動 GUI 介面中,按下藍色的「部署」按鈕或執行這個殼層 部署程式碼:

$ appcfg.py --oauth2 update .