Español – América Latina Português – Brasil Google Workspace 凭据用于从 Google 的授权服务器获取访问令牌，以便您的应用可以调用 Google Workspace API。本文档介绍了如何选择和设置应用所需的凭据。 所需的凭据取决于应用的数据类型、平台和访问方法。有三种类型的凭据可用： 如需了解本页面上术语的定义，请参阅 身份验证和 授权概览 。 API 密钥是一个包含大写字母、小写字母、数字、下划线和连字符的长字符串，例如 AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe 。 此身份验证方法用于匿名访问公开提供的数据，例如使用“拥有此链接的任何人”共享设置共享的 Google Workspace 文件。如需了解详情，请参阅 管理 API 密钥 。 如需创建 API 密钥，请执行以下操作： 在 Google Cloud 控制台中，依次点击“菜单”图标 menu > API 和服务 > 凭据 。 进入“凭据”页面 点击 创建凭据 > API 密钥 。 系统会显示新的 API 密钥。 点击“复制”图标 content_copy ，复制 API 密钥以在应用的代码中使用 。您还可以在项目的凭据的"API 密钥"部分中找到 API 密钥。 为防止未经授权的使用，我们建议您限制此 API 密钥 可用于哪些位置和 API。如需了解详情，请参阅 添加 API 限制 。 点击“复制”图标 content_copy ，复制 API 密钥以在应用的代码中使用 。您还可以在项目的凭据的"API 密钥"部分中找到 API 密钥。 为防止未经授权的使用，我们建议您限制此 API 密钥 可用于哪些位置和 API。如需了解详情，请参阅 添加 API 限制 。 OAuth 客户端 ID 凭据 选择您的 应用 类型 ，以获取有关如何创建 OAuth 客户端 ID 的具体说明： 在 Google Cloud 控制台中，依次点击“菜单”图标 menu > Google 身份验证平台 > 客户端 。 进入“客户端”页面 依次点击 应用类型 > Web 应用 。 在 名称 字段中，输入凭据的名称。此名称仅在 Google Cloud 控制台中显示。 添加与应用相关的已获授权的 URI： 客户端应用 (JavaScript) \- 在 已获授权的 JavaScript 来源 下，点击 添加 URI 。然后，输入要用于浏览器请求的 URI。这会标识您的应用可以向 OAuth 2.0 服务器发送 API 请求的网域。 服务器端应用（Java、Python 等） \- 在 已获授权的重定向 URI 下，点击 添加 URI 。然后，输入 OAuth 2.0 服务器可以向其发送响应的端点 URI。 客户端应用 (JavaScript) \- 在 已获授权的 JavaScript 来源 下，点击 添加 URI 。然后，输入要用于浏览器请求的 URI。这会标识您的应用可以向 OAuth 2.0 服务器发送 API 请求的网域。 服务器端应用（Java、Python 等） \- 在 已获授权的重定向 URI 下，点击 添加 URI 。然后，输入 OAuth 2.0 服务器可以向其发送响应的端点 URI。 点击 创建 。 新创建的凭据会显示在 OAuth 2.0 客户端 ID 下。 请注意，客户端密钥不适用于 Web 应用。 新创建的凭据会显示在 OAuth 2.0 客户端 ID 下。 请注意，客户端密钥不适用于 Web 应用。 在 Google Cloud 控制台中，依次点击“菜单”图标 menu > Google 身份验证平台 > 客户端 。 进入“客户端”页面 依次点击 应用类型 > Android 。 在 名称 字段中，输入凭据的名称。此名称仅在 Google Cloud 控制台中显示。 在 软件包名称 字段中，输入 AndroidManifest.xml 文件中的软件包名称。 在 SHA-1 证书指纹 字段中，输入您的 生成的 SHA-1 证书指纹 。 点击 创建 。 新创建的凭据会显示在“OAuth 2.0 客户端 ID”下。 新创建的凭据会显示在“OAuth 2.0 客户端 ID”下。 在 Google Cloud 控制台中，依次点击“菜单”图标 menu > Google 身份验证平台 > 客户端 。 进入“客户端”页面 依次点击 应用类型 > iOS 。 在 名称 字段中，输入凭据的名称。此名称仅在 Google Cloud 控制台中显示。 在 软件包 ID 字段中，输入应用的 Info.plist 文件中列出的软件包标识符。 可选：如果您的应用显示在 Apple App Store 中，请输入 App Store ID。 可选：在 团队 ID 字段中，输入由 Apple 生成并分配给您的团队的唯一字符串，该字符串包含 10 个字符。 点击 创建 。 新创建的凭据会显示在“OAuth 2.0 客户端 ID”下。 新创建的凭据会显示在“OAuth 2.0 客户端 ID”下。 在 Google Cloud 控制台中，依次点击“菜单”图标 menu > Google 身份验证平台 > 客户端 。 进入“客户端”页面 依次点击 应用类型 > Chrome 扩展程序 。 在 名称 字段中，输入凭据的名称。此名称仅在 Google Cloud 控制台中显示。 在 商品 ID 字段中，输入应用的唯一 32 字符 ID 字符串。您可以在应用的 Chrome 应用商店网址和 Chrome 应用商店开发者信息中心 内找到此 ID 值。 点击 创建 。 新创建的凭据会显示在“OAuth 2.0 客户端 ID”下。 新创建的凭据会显示在“OAuth 2.0 客户端 ID”下。 在 Google Cloud 控制台中，依次点击“菜单”图标 menu > Google 身份验证平台 > 客户端 。 进入“客户端”页面 依次点击 应用类型 > 桌面应用 。 在 名称 字段中，输入凭据的名称。此名称仅在 Google Cloud 控制台中显示。 点击 创建 。 新创建的凭据会显示在“OAuth 2.0 客户端 ID”下。 新创建的凭据会显示在“OAuth 2.0 客户端 ID”下。 在 Google Cloud 控制台中，依次点击“菜单”图标 menu > Google 身份验证平台 > 客户端 。 进入“客户端”页面 依次点击 应用类型 > 电视和受限输入设备 。 在 名称 字段中，输入凭据的名称。此名称仅在 Google Cloud 控制台中显示。 点击 创建 。 新创建的凭据会显示在“OAuth 2.0 客户端 ID”下。 新创建的凭据会显示在“OAuth 2.0 客户端 ID”下。

请注意，在 Google Cloud 控制台中配置的 Identity and Access Management (IAM) 角色 不会 授予对 Google Workspace 资产 （例如 Google 表格或 Gmail）的访问权限。如需授予服务账号对 Google Workspace 资源的访问权限，您可以使用以下方法： 您可以使用 Google Cloud 控制台或 gcloud 命令行工具创建服务账号。 Google Cloud 控制台 在 Google Cloud 控制台中，依次点击“菜单”图标 menu > IAM 和管理 > 服务账号 。 转到“服务账号” 其余步骤会显示在 Google Cloud 控制台中。 其余步骤会显示在 Google Cloud 控制台中。 选择 Google Cloud 项目。 输入要在 Google Cloud 控制台中显示的服务账号名称。 如果您现在不想设置访问权限控制，请点击 完成 以完成服务账号的创建过程。如需立即设置访问权限控制，请点击 创建并继续 ，然后继续执行下一步。 可选：为服务账号分配角色，以授予对 Google Cloud 项目的资源以及 Google Workspace 资源的访问权限。如需了解详情，请参阅 管理对项目、文件夹和组织的访问权限 。 可选：输入可以管理此服务账号并使用其执行操作的用户或群组。如需了解详情，请参阅 服务账号模拟 。 点击 完成 以完成服务账号的创建过程。 记下服务账号的电子邮件地址。 创建服务账号： gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \ --display-name=" SERVICE_ACCOUNT_NAME " 可选：为服务账号分配角色，以授予对 Google Cloud 项目的资源以及 Google Workspace 资源的访问权限。如需了解详情，请参阅 管理对项目、文件夹和组织的访问权限 。 使用服务账号直接访问 Google Workspace 文件 如果您的应用只需要读取或写入特定文件（例如 Google 表格或 Google 云端硬盘文件夹），则无需分配管理员角色或配置全网域授权。相反，您可以使用标准界面直接与服务账号的电子邮件地址共享各个文件。您可以将服务账号的电子邮件地址视为文档共享设置中的用户账号，而无需管理员权限。 复制服务账号的电子邮件地址。例如， my-service-account@my-project.iam.gserviceaccount.com 。 打开您要访问的 Google 表格文档或 Google 云端硬盘文件夹。 添加服务账号的电子邮件地址，并分配适当的访问权限级别（例如“编辑者”或“查看者”）。 取消选择 通知用户 （由于服务账号没有收件箱，因此不会收到邮件邀请，但仍会授予权限）。 如需创建服务账号密钥，请执行以下操作： 在 Google Cloud 控制台中，依次点击“菜单”图标 menu > IAM 和管理 > 服务账号 。 转到“服务账号” 其余步骤会显示在 Google Cloud 控制台中。 其余步骤会显示在 Google Cloud 控制台中。 选择 Google Cloud 项目。 点击要为其创建密钥的服务账号的电子邮件地址。 点击 添加密钥 下拉菜单，然后选择 创建新密钥 。 选择 JSON 作为 密钥类型 ，然后点击 创建 。 系统会生成新的公钥/私钥对，并以服务账号密钥文件的形式下载到您的 计算机。将下载的 JSON 文件另存为工作目录中的 credentials.json 。此文件是此密钥的唯一副本。下载密钥文件后，您无法再次下载。如需了解如何安全地存储 密钥，请参阅 管理服务账号密钥的最佳实践 。 系统会生成新的公钥/私钥对，并以服务账号密钥文件的形式下载到您的 计算机。将下载的 JSON 文件另存为工作目录中的 credentials.json 。此文件是此密钥的唯一副本。下载密钥文件后，您无法再次下载。如需了解如何安全地存储 密钥，请参阅 管理服务账号密钥的最佳实践 。 为服务账号分配 Google Workspace 管理员角色 您可以为服务账号分配任何预先创建的或自定义的 Google Workspace 角色，但超级用户角色除外。 在 Google 管理控制台中，依次点击“菜单”图标 menu > alternate_email 账号 > 管理员角色 。 转到“管理员角色” 您必须以 超级用户 身份登录才能执行此任务。 其余步骤会显示在 Google 管理控制台中。 在 Google 管理控制台中，依次点击“菜单”图标 menu > alternate_email 账号 > 管理员角色 。 您必须以 超级用户 身份登录才能执行此任务。 其余步骤会显示在 Google 管理控制台中。 将光标指向要分配的角色，点击 Actions 下拉菜单，然后选择 分配管理员角色 。 将光标指向要分配的角色，点击 Actions 下拉菜单，然后选择 分配管理员角色 。 依次点击 添加 > 分配角色 。 依次点击 添加 > 分配角色 。 可选：为服务账号设置全网域授权 如需为服务账号设置全网域授权，请执行以下操作： 在 Google Cloud 控制台中，依次点击“菜单”图标 menu > IAM 和管理 > 服务账号 。 转到“服务账号” 选择 Google Cloud 项目。 点击要为其设置全网域授权的服务账号的电子邮件地址。 在“全网域授权”下，找到服务账号的“客户端 ID”。 点击“复制”图标 content_copy ，将客户端 ID 值复制到剪贴板。 如果您拥有对相关 Google Workspace 账号的 超级用户 访问权限，请点击 查看 Google Workspace 管理控制台 ，使用超级用户账号登录，然后继续执行以下步骤。 如果您没有对相关 Google Workspace 账号的超级用户访问权限， 请与该账号的超级用户联系。向他们发送服务账号的客户端 ID 和应用所需的 OAuth 范围列表，以便他们可以在 Google 管理控制台中完成以下步骤。 如果您拥有对相关 Google Workspace 账号的 超级用户 访问权限，请点击 查看 Google Workspace 管理控制台 ，使用超级用户账号登录，然后继续执行以下步骤。 如果您没有对相关 Google Workspace 账号的超级用户访问权限， 请与该账号的超级用户联系。向他们发送服务账号的客户端 ID 和应用所需的 OAuth 范围列表，以便他们可以在 Google 管理控制台中完成以下步骤。 在 Google 管理控制台中，依次点击“菜单”图标 menu > 安全性 > 访问权限和数据控件 > API 控件 。 前往“API 控件” 在 客户端 ID 字段中，粘贴您之前复制的客户端 ID。 在 OAuth 范围 字段中，输入应用所需的范围的英文逗号分隔列表。这与您在配置 OAuth 权限请求页面时定义的一组范围相同。 点击 授权 。 更改最长可能需要 24 小时生效，但通常会更快完成。如需了解详情，请参阅 使用全网域授权功能控制 API 访问权限 。 更改最长可能需要 24 小时生效，但通常会更快完成。如需了解详情，请参阅 使用全网域授权功能控制 API 访问权限 。 您已准备好在 Google Workspace 上进行开发！查看 Google Workspace 开发者产品 列表以及 如何 寻求帮助 。 如未另行说明，那么本页面中的内容已根据 知识共享署名 4.0 许可 获得了许可，并且代码示例已根据 Apache 2.0 许可 获得了许可。有关详情，请参阅 Google 开发者网站政策 。Java 是 Oracle 和/或其关联公司的注册商标。 最后更新时间 (UTC)：2026-09-11。