配置您的应用

如需开始使用 Google Photos API，请使用 Google API 控制台启用所需的 Photos API 并设置 OAuth 2.0 客户端 ID，以配置您的项目。

您的应用会代表 Google 相册用户与 Google 相册进行互动。例如，当您在用户的 Google 相册媒体库中创建影集或将媒体内容上传到用户的 Google 相册账号时，该用户会使用 OAuth 2.0 协议授权这些 API 请求。

通过 OAuth 2.0 客户端 ID，您的应用用户可以登录和进行身份验证，从而使用 Photos API。Photos API 不支持服务账号；如需使用这些 API，用户必须登录有效的 Google 账号。

配置您的应用

请先启用 API，然后申请 OAuth 2.0 客户端 ID。

启用 API

您必须先在项目中启用 Photos API，然后才能使用它们。

  1. 转到 Google API 控制台。
  2. 从菜单栏中选择一个项目或创建一个新项目。
  3. 如需打开 Google 相册 API，请在导航菜单中依次选择 API 和服务 > 库。
  4. 搜索“照片”。选择一个或多个 Google 相册 API，然后点击启用。

Google Cloud 控制台中的选择器 API 的屏幕截图

请求 OAuth 2.0 客户端 ID

请按照以下步骤请求 OAuth 客户端 ID 并为您的应用进行配置。此示例使用的应用在服务器端处理整个 OAuth 流程，例如我们示例中的应用。对于其他实现场景，设置过程可能会有所不同。

  1. 前往 Google API 控制台，然后选择您的项目。
  2. 在菜单中，依次选择 API 和服务 > 凭据。

  3. 在凭据页面上，点击创建凭据 > OAuth 客户端 ID。

  4. 选择您的应用类型。在此示例中，应用类型为 Web 应用。

  5. 按照以下步骤注册允许您的应用从其访问 Google API 的来源：

    1. 为标识客户端 ID，请输入名称。
    2. 在已获授权的 JavaScript 来源字段中，为您的应用输入源站。此字段不支持通配符。

    您可以输入多个源站，以允许您的应用在不同的协议、网域或子网域上运行。输入的网址可以启动 OAuth 请求。

    以下示例展示本地的开发环境网址（在我们的示例中为 localhost:8080）和生产环境网址。

        http://localhost:8080
    https://myproductionurl.example.com
    ```

1.  The **Authorized redirect URI** field is the endpoint that receives
    responses from the OAuth 2.0 server. Typically, this includes your
    development environment and points to a path in your application.

```none
    http://localhost:8080/auth/google/callback
    https://myproductionurl.example.com/auth/google/callback
    ```

1.  Click **Create**.

  1. 在显示的 OAuth 客户端对话框中，复制以下内容：

    • 客户 ID
    • 客户端密钥

    利用这些值，您的应用便可访问已启用的 Google API。

在您启动访问 Google 相册 API 的公开应用前，您的应用必须经过 Google 审核。测试应用时，屏幕上会显示“未经验证的应用”消息，直至应用通过验证。

配置应用后，您就可以开始了：

更改客户端 ID

通过任何 Google Photos API 创建的资源只能使用创建它们的原始客户端 ID 进行访问或修改。例如，如果您使用特定客户端 ID 在 Picker API 中创建了“会话”，之后又在应用中更改了该客户端 ID，则您的应用将无法再访问使用之前的客户端 ID 创建的任何 API 资源。

请仔细规划，并为您使用的 Photos API 选择正确的客户端 ID 类型。请仅在绝对必要时更改您的客户端 ID，以免出现访问问题。