這個專案說明如何實作簡單的 Glassware 功能,並示範 Google Mirror API 的主要功能。
如要查看快速入門專案的完整運作範例,請前往 https://glass-python-starter-demo.appspot.com。否則,請繼續閱讀如何部署自己的版本。
必要條件
確認您的系統符合快速入門專案的下列先決條件:
- Java 1.6
- Apache Maven:用於建構程序的一部分。
建立 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
) 和已部署網路伺服器的回呼網址 (例如https://example.com/oauth2callback
)。 - 在 Google API 控制台中記下用戶端 ID 和密鑰。您需要這個金鑰來設定快速入門專案。
設定快速入門專案
將用戶端 ID 和密鑰輸入至 src/main/resources/oauth.properties
以設定快速入門專案,以使用您的 API 用戶端資訊:
# Replace these with values for your project from the Google API Console:
# https://developers.google.com/console
client_id=3141592653589793238462643383279
client_secret=ITS_A_SECRET_TO_EVERYBODY
匯入專案
以下操作說明將 QuickStart 專案來源匯入 IntelliJ 和 Eclipse。
IntelliJ
- 依序按一下 [File] (檔案) > [Import Project...] (匯入專案...)。
- 將滑鼠遊標移至擷取的目錄。
- 依序選取 [Import from existing model] (從現有模型匯入) > [Maven]。
Eclipse
- 安裝
m2e
外掛程式即可從 Maven pom 檔案匯入。 - 按一下 [檔案] > [匯入...]。> [Maven] > [現有 Maven 專案]。
- 將滑鼠遊標移至擷取的目錄,然後匯入專案。
執行本機開發環境
您可以在本機開發伺服器執行「快速入門」專案,以進行測試:
$ mvn jetty:run
部署快速入門專案
您可以使用 Maven 為這項專案建立 war 檔案:
$ mvn war:war