Python 快速入门

此项目介绍了如何实现一个简单的 Glassware,用于演示 Google 镜像 API 的主要功能。

如需查看该快速入门项目的完整运作演示,请访问 https://glass-python-starter-demo.appspot.com。否则,请继续阅读,了解如何部署您自己的版本。

在 GitHub 上下载

前提条件

适用于 Python 的 App Engine SDK - Python 快速入门项目是使用 App Engine 实现的。您需要使用 Python App Engine SDK 来开发和部署项目。运行适合您的平台的平台安装程序,或将 ZIP 文件解压到一个方便的位置。

创建 Google App Engine 实例

您需要在 Google App Engine 实例上托管快速入门项目:

  1. 访问 http://appspot.com
  2. 点击创建应用,然后创建托管在 appspot.com 上的公共 Google App Engine 实例。
  3. 为应用提供应用标识符,并让身份验证对 Google 帐号的所有用户开放。您稍后需要使用应用标识符来配置快速入门项目。

创建 Google API 控制台项目

接下来,启用 Google 镜像 API 的访问权限:

  1. 转到 Google API 控制台并创建新的 API 项目。
  2. 点击 Services,然后为新项目启用 Google 镜像 API。 Google API 控制台中的 Google 镜像 API
  3. 点击 API Access 并为 Web 应用创建 OAuth 2.0 客户端 ID。 Google API 控制台的“API Access”部分
  4. 指定您的 Glassware 产品名称和图标。这些字段会显示在向用户显示的 OAuth 授权屏幕上。指定品牌信息
  5. 选择 Web 应用,并为主机名指定任何值,例如 localhost 选择应用类型
  6. 点击客户端 ID 对应的修改设置...,以指定重定向 URI。为 App Engine 实例指定 http://localhost:8080/oauth2callback 和回调网址,例如 https://myappengineinstance.appspot.com/oauth2callback用于重定向 URI 的 Google API 控制台配置面板
  7. 记下 Google API 控制台中的客户端 ID 和密钥。您需要使用它来配置快速入门项目。 Google API 控制台中的客户端 ID 和密钥

配置项目

将“快速入门”项目配置为使用您的 API 客户端信息:

  1. 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"
      }
    }
  2. 生成 session.secret 文件以存储会话 Cookie:
    $ python -c "import os; print os.urandom(64)" > session.secret
  3. 修改 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 .