此项目介绍了如何实现一个简单的 Glassware,用于演示 Google 镜像 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。
- 点击创建应用,然后创建托管在
appspot.com
上的公共 Google App Engine 实例。 - 为应用提供应用标识符,并让身份验证对 Google 帐号的所有用户开放。您稍后需要使用应用标识符来配置快速入门项目。
创建 Google API 控制台项目
接下来,启用 Google 镜像 API 的访问权限:
- 转到 Google API 控制台并创建新的 API 项目。
- 点击 Services,然后为新项目启用 Google 镜像 API。
- 点击 API Access 并为 Web 应用创建 OAuth 2.0 客户端 ID。
- 指定您的 Glassware 产品名称和图标。这些字段会显示在向用户显示的 OAuth 授权屏幕上。
- 选择 Web 应用,并为主机名指定任何值,例如
localhost
- 点击客户端 ID 对应的修改设置...,以指定重定向 URI。为 App Engine 实例指定
http://localhost:8080/oauth2callback
和回调网址,例如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 界面中的蓝色部署按钮,或运行以下 shell 命令部署代码:
$ appcfg.py --oauth2 update .