Python 快速入門

這個專案說明如何實作簡單的 Glassware 功能，並示範 Google Mirror API 的主要功能。

如要查看快速入門專案的完整運作範例，請前往 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. 為應用程式提供應用程式 ID，並將「Open to all Google Accounts users」(開放所有 Google 帳戶使用者) 的驗證保持開啟。稍後必須使用應用程式 ID 設定快速入門專案。

建立 Google API 控制台專案

接著，請啟用 Google Mirror API 的存取權：

1. 前往 Google API 主控台，建立新的 API 專案。
2. 按一下「Service」，然後為新專案啟用 Google Mirror API。
3. 按一下 [API Access] (API 存取權)，然後為網路應用程式建立 OAuth 2.0 用戶端 ID。
4. 指定 Glassware 的產品名稱與圖示。這些欄位會顯示在向使用者顯示的 OAuth 授權畫面上。
5. 選取「Web Application」，然後指定主機名稱的任何值，例如 localhost
6. 針對用戶端 ID 按一下 [Edit settings...]，即可指定重新導向 URI。指定 http://localhost:8080/oauth2callback 和 App Engine 執行個體的回呼網址，例如 https://myappengineinstance.appspot.com/oauth2callback。
7. 在 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 介面中按下藍色的 [Deploy] 按鈕，或是執行此殼層指令來部署程式碼：

$ appcfg.py --oauth2 update .