配置您的应用

如需开始使用 Google 相册 API，请使用 Google API 控制台启用所需的 Google 相册 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 API 时，您可能还会看到“Google Picker API”，它与 Google Photos Picker API 不同。

请求 OAuth 2.0 客户端 ID

请按照以下步骤请求 OAuth 客户端 ID 并为您的应用配置该 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
      

   3. 已获授权的重定向 URI 字段是接收 OAuth 2.0 服务器响应的端点。通常情况下，该端点包含您的开发环境并指向您应用中的路径。

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

   4. 点击创建。

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

   • 客户 ID
   • 客户端密钥

   您的应用可以使用这些值访问已启用的 Google API。

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

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

• Picker API 使用入门
• 开始使用 Library API

更改客户端 ID

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

请仔细规划，为您使用的 Google 相册 API 选择正确的客户端 ID 类型。请仅在绝对必要的情况下更改您的客户端 ID，以避免访问问题。