对零触摸注册转销商 API 的 API 调用需要授权。 要求授权可保护贵组织的数据。要授权对 零触摸注册 API,则需要完成以下任务:
- 创建服务账号以调用 API。
- 存储 JSON 密钥文件以授权 API 调用。
- 启用 API,使其可供服务使用 。
- 关联服务账号,以代表您的 组织。
以下说明可帮助您完成这些任务。
第 1 步:创建服务账号
服务账号(有时称为机器人账号)是 Google 账号 代表应用而非用户您的应用会代表 这样用户就不必直接参与其中因为您的应用使用的是 Google API,请使用 Google API 控制台设置访问权限。
创建 API 控制台项目
最好是创建新的 API 控制台项目和服务 账号。这样可以管理访问权限、管理资源并修复 避免丢失钥匙首先,请按以下步骤创建 在 Google API 控制台中新建项目:
如需了解详情,请参阅 Google Cloud Platform 文档在以下位置管理项目: 控制台。
添加新服务凭据
如需向您的项目添加新凭据和服务账号,请按照下列步骤操作: 下方的 API 控制台中。
- 打开服务账号页面。如果看到提示,请选择项目。
- 点击 创建服务账号,并输入服务账号的名称和说明。您可以使用默认服务账号 ID,也可以选择其他唯一的账号 ID。完成后,点击创建。
- 后面的服务账号权限(可选)部分无需设置。点击继续。
- 在向用户授予访问此服务账号的权限屏幕上,向下滚动到创建密钥部分。点击 创建密钥。
- 在随即显示的侧面板中,选择密钥的格式:建议使用 JSON。
- 点击创建。您的新公钥/私钥对随后会生成并下载到您的计算机上;该密钥仅此一份。要了解如何安全地存储密钥,请参阅管理服务账号密钥。
- 点击私钥已保存到您的计算机对话框中的关闭,然后点击完成以返回服务账号表格。
复制服务账号的电子邮件地址,以便随时使用。您需要 并在稍后将服务账号与您的组织关联时启用。
第 2 步:存储 JSON 密钥文件
API 控制台生成一个用于进行身份验证的新私钥对 使用您的服务账号进行的 API 调用。私钥包含在 JSON 密钥中 文件。
您应将密钥保持为私有,因此请不要将其包含在应用的源代码中。 如果您丢失了密钥文件,则需要生成一对新密钥。
要详细了解如何安全地存储密钥文件,请参阅有关 安全地使用 API 密钥。
第 3 步:启用 API
您需要先启用 API,然后应用才能使用该 API。启用 API 将其与当前的 API 控制台项目相关联, 监控页面。
如需启用此 API,请在您的 API 控制台中执行以下步骤:
- 点击 API 和服务 >库。
- 使用搜索字段查找 Android Device Provisioning Partner API。
- 点击 Android Device Provisioning Partner API。
- 点击启用。
短暂延迟后,API 状态将更改为已启用。如果没有看到 Android Device Provisioning Partner API,请检查贵组织是否已完成初始配置 进行零触摸注册请确保您对 零触摸注册和 Google API 控制台。咨询您的 Google 平台解决方案 让顾问来检查您的 Google 账号是否有权访问该 API。
第 4 步:关联服务账号
将服务账号与贵组织的零触摸注册相关联 将授权该服务账号代表您进行 API 调用 组织。请按照以下步骤关联您的服务账号:
- 打开零触摸注册门户。您可能需要登录。
- 点击 服务 账号。
- 点击 关联服务账号。
- 将电子邮件地址设置为您创建的服务账号的地址。
- 点击关联服务账号,通过零触摸功能使用服务账号 注册账号。
如果您找不到自己创建的服务账号的电子邮件地址,请复制该地址 :
- 服务账号电子邮件地址(来自 Google API 控制台中的服务账号页面。
- JSON 密钥文件中的
client_email
属性字段。
现在,您的服务账号可以代表您的 组织。
试用 API
按照获取 开始。
授权范围
使用 API 授权范围
在应用的 https://www.googleapis.com/auth/androidworkprovisioning
中请求
OAuth 2.0 访问令牌
范围参数用于控制访问权限 令牌允许调用 。访问令牌仅对一组操作有效 令牌请求范围内描述的资源。该 API 涵盖 显示了单一零触摸注册范围的方法和资源 。
有关 Google API 使用的零触摸注册范围的示例 客户端库,请参阅使用入门。详细了解如何使用 Google API 范围,读取 使用 OAuth 2.0 访问 Google API。