這個專案說明如何實作簡單的 Glassware 功能,並示範 Google Mirror API 的主要功能。
如要查看快速入門專案的完整運作範例,請前往 https://glass-python-starter-demo.appspot.com。否則,請繼續閱讀如何部署自己的版本。
必要條件
Python 適用的 App Engine SDK - Python 的快速入門專案是使用 App Engine 實作。您必須使用 Python App Engine SDK 才能開發及部署專案。請視情況針對您的平台執行安裝程式,或是將 ZIP 檔案解壓縮到方便的位置。
建立 Google App Engine 執行個體
您必須在 Google App Engine 的執行個體上託管快速入門專案:
- 前往 http://appspot.com。
- 按一下 [Create Application] (建立應用程式),並建立託管於
appspot.com
的公開 Google App Engine 執行個體。 - 為應用程式提供應用程式 ID,並將「Open to all Google Accounts users」(開放所有 Google 帳戶使用者) 的驗證保持開啟。稍後必須使用應用程式 ID 設定快速入門專案。
建立 Google API 控制台專案
接著,請啟用 Google Mirror API 的存取權:
- 前往 Google API 主控台,建立新的 API 專案。
- 按一下「Service」,然後為新專案啟用 Google Mirror API。
- 按一下 [API Access] (API 存取權),然後為網路應用程式建立 OAuth 2.0 用戶端 ID。
- 指定 Glassware 的產品名稱與圖示。這些欄位會顯示在向使用者顯示的 OAuth 授權畫面上。
- 選取「Web Application」,然後指定主機名稱的任何值,例如
localhost
- 針對用戶端 ID 按一下 [Edit settings...],即可指定重新導向 URI。指定
http://localhost:8080/oauth2callback
和 App Engine 執行個體的回呼網址,例如https://myappengineinstance.appspot.com/oauth2callback
。 - 在 Google API 控制台中記下用戶端 ID 和密鑰。您需要這個金鑰來設定快速入門專案。
設定專案
設定快速入門專案以使用 API 用戶端資訊:
- 在
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" } }
- 產生
session.secret
檔案來儲存工作階段 Cookie:$ python -c "import os; print os.urandom(64)" > session.secret
- 編輯
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 .