创建客户端 ID

如果您希望 API 后端需要经过身份验证才能访问，则必须获取所需的客户端 ID，并使用正确的 API 注解属性将其提供给后端。

Android

如需创建 OAuth 2.0 Android 客户端 ID，您需要具备证书密钥指纹。如果您使用 Android Studio，系统会自动创建调试密钥库和调试密钥。您可以使用调试密钥进行测试，但若要投入生产，则必须使用发布密钥。

请注意，默认的调试密钥库密码是 android，密钥别名是 androiddebugkey。对于 Linux 和 macOS，默认位置是 ~/.android/debug.keystore。

  1. 为 Android 应用生成一个调试密钥或发布密钥（如果您还没有的话）。如果您使用 Android Studio，它会在您首次构建一个 Android 项目时，自动在调试密钥库中生成调试密钥。
  2. 在 Linux 或 macOS 终端窗口中，您可以使用 Java SDK 附带的 keytool 获取密钥的指纹，如下所示： 
    keytool -exportcert -alias androiddebugkey -keystore path-to-debug-or-production-keystore -list -v
    输出会显示类似于以下内容的指纹： DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09
  3. 复制并保存在运行上述 keytool 命令后显示的密钥指纹。您需要提供该指纹才能在 Google Cloud 控制台中生成 Android 客户端 ID。
  4. 在 Google Cloud 控制台中，前往凭据页面。

    转到“凭据”页面

  5. 从项目列表中，选择包含您的 API 的项目。
  6. 如果这是您第一次在此项目中创建客户端 ID，请按照子步骤转到 OAuth 同意页面；否则，请跳至下一步。
    1. 点击 OAuth 同意屏幕。
    2. 在应用名称字段中输入一个名称。
    3. 按需填写其余字段。
    4. 点击保存。
  7. 在创建凭据下拉列表中，选择 OAuth 客户端 ID。
  8. 选择 Android 作为应用类型。
  9. 在名称中，输入客户端 ID 的名称。
  10. 在签名证书指纹中，输入您之前获得的指纹。
  11. 在软件包名称中，输入 AndroidManifest.xml 文件中指定的 Android 应用软件包名称。
  12. 点击创建。

    您可以在 API 后端和客户端应用中使用生成的客户端 ID。

Web 客户端

  1. 在 Google Cloud 控制台中，前往凭据页面。

    转到“凭据”页面

  2. 从项目列表中，选择包含您的 API 的项目。
  3. 如果这是您第一次在此项目中创建客户端 ID，请按照子步骤转到 OAuth 同意页面；否则，请跳至下一步。
    1. 点击 OAuth 同意屏幕。
    2. 在应用名称字段中输入一个名称。
    3. 按需填写其余字段。
    4. 点击保存。
  4. 在创建凭据下拉列表中，选择 OAuth 客户端 ID。
  5. 选择 Web 应用作为应用类型。
  6. 在名称中，输入客户端 ID 的名称。
  7. 在已获授权的 JavaScript 来源中，输入以下内容中的一项：
    • http://localhost:8080（如果您在本地测试后端）。

    • https://YOUR_PROJECT_ID.appspot.com，如果要将后端 API 部署到正式版 App Engine，请将 YOUR_PROJECT_ID 替换为您的 App Engine 项目 ID。

  8. 点击创建。

    您可以在 API 后端和客户端应用中使用生成的客户端 ID。

后续步骤

要详细了解如何在 Android 或 JavaScript 应用中支持身份验证，请参阅以下内容：