這個專案說明如何實作簡單的 Glassware 功能,並示範 Google Mirror API 的主要功能。
如要查看快速入門專案的完整運作範例,請前往 https://glass-python-starter-demo.appspot.com。否則,請繼續閱讀如何部署自己的版本。
必要條件
- PHP 5.3.x 以上版本
- 網路伺服器:您需要存放代管檔案的位置。 Apache httpd 和 kube 工作十分出色。
- 如要使用訂閱項目,您還需要可使用可信任的憑證授權單位所簽署的有效 SSL 憑證的網際網路存取主機。
建立 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、密鑰、簡易 API 金鑰、基本網址,以及可在 config.php
建立 SQLite 資料庫的位置:
$api_client_id = "1234.apps.googleusercontent.com";
$api_client_secret = "ITS_A_SECRET_TO_EVERYBODY";
$api_simple_key = "AIzaSyCCbHcqDeb0oycQ9niV8P3n0F0qM";
$base_url = "http://example.com/starter-project";
$sqlite_database = "/tmp/database.sqlite";
部署專案
將快速入門專案部署到您的主機伺服器:
- 將 PHP 快速入門目錄複製到 HTTP 網路伺服器的文件目錄。
視您的系統設定而定,您可能需要預先為 SQLite 資料庫建立可寫入的檔案:
$ touch /tmp/database.sqlite $ chmod 777 /tmp/database.sqlite