此项目介绍了如何实现一个简单的 Glassware,用于演示 Google 镜像 API 的主要功能。
如需查看该快速入门项目的完整运作演示,请访问 https://glass-python-starter-demo.appspot.com。否则,请继续阅读,了解如何部署您自己的版本。
前提条件
确保您的系统满足快速入门项目的以下前提条件:
- Java 1.6
- Apache Maven - 用于构建流程的一部分。
创建 Google API 控制台项目
接下来,启用 Google 镜像 API 的访问权限:
- 转到 Google API 控制台并创建新的 API 项目。
- 点击 Services,然后为新项目启用 Google 镜像 API。
- 点击 API Access 并为 Web 应用创建 OAuth 2.0 客户端 ID。
- 指定您的 Glassware 产品名称和图标。这些字段会显示在向用户显示的 OAuth 授权屏幕上。
- 选择 Web 应用,并为主机名指定任何值,例如
localhost
- 点击客户端 ID 对应的修改设置...,以指定重定向 URI。为本地开发网络服务器(例如
http://localhost:8080/oauth2callback
)和已部署的网络服务器(例如https://example.com/oauth2callback
)指定回调网址。 - 记下 Google API 控制台中的客户端 ID 和密钥。您需要使用它来配置快速入门项目。
配置快速入门项目
在 src/main/resources/oauth.properties
中输入客户端 ID 和密钥,将“快速入门”项目配置为使用您的 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
导入项目
以下说明介绍了如何将快速入门项目源代码导入 IntelliJ 和 Eclipse。
IntelliJ
- 依次点击 File > Import Project...。
- 将光标指向解压的目录。
- 选择从现有模型导入 > Maven
Eclipse
- 安装
m2e
插件,以便从 Maven pom 文件导入。 - 点击文件 > 导入... > Maven > Existing Maven Project。
- 将光标指向提取的目录并导入项目。
运行本地开发服务器
您可以在本地开发服务器上运行快速入门项目以进行测试:
$ mvn jetty:run
部署快速入门项目
您可以使用 Maven 为此项目构建战争文件:
$ mvn war:war