技术设置

准备工作

在开始之前，您需要满足以下条件：

• 对转销商网域的超级用户访问权限。如需了解详情，请参阅如何访问 Cloud Channel API。

• 访问 Google Cloud 控制台和 Partner Sales Console。

第 1 步：准备好 Partner Sales Console

您必须先接受渠道服务平台的条款及条件，然后才能使用此 API。

以转销商网域的管理员身份至少登录一次 Partner Sales Console。首次登录时，您必须接受转销商服务条款（如果适用）。如果您已在线下接受了特定服务条款，则此步骤不适用于您。

您可以在 Partner Sales Console 的“条款”页面上接受其他服务条款。

注意 ：您需要在 Partner Sales Console 的“设置”页面中找到您的账号 ID，以便进行 API 集成。

第 2 步：配置 Google Cloud 项目

如需使用任何 Google API，您必须拥有一个 Google Cloud 项目。

创建 Google Cloud 项目

如需创建项目，请前往 Google Cloud 控制台的项目区域，然后点击 创建项目。

如需有关创建项目的更详细说明以及最佳实践列表，请参阅我们的创建和管理项目指南。

大多数转销商会在其主要 Google Cloud 组织下创建 Google Cloud 项目，而不是在转销商网域下创建。若要授予对转销商网域中数据的访问权限，您需要设置全网域授权，以便服务账号访问转销商网域中的数据。

为项目指定一个描述性名称。项目 ID 是一个任意标识符，不会影响您调用 Cloud Channel API 的能力。

启用该 API

前往 Google Cloud 控制台中的 API 库部分，然后启用 Cloud Channel API。

创建服务账号

如需创建服务账号，请前往服务账号页面。

转到“服务账号”

注意：如果服务账号密钥未得到适当的管理，则会带来安全风险。您应该尽可能选择更安全的服务账号密钥替代方案。如果必须使用服务账号密钥进行身份验证，您将负责私钥的安全性以及管理服务账号密钥的最佳实践中所述的其他操作。如果系统阻止您创建服务账号密钥，您的组织可能会停用服务账号密钥创建功能。如需了解详情，请参阅管理默认安全的组织资源。

1. 点击创建服务账号。
2. 输入服务账号名称（以及可选的服务账号说明），然后点击创建。
3. 点击继续以跳过向服务账号授予对项目的访问权限选项。
4. 跳过向用户授予访问此服务账号的权限部分，然后点击完成以完成账号创建。

创建账号后，创建服务账号密钥：

1. 在 Google Cloud 控制台中，点击您创建的服务账号的电子邮件地址。
2. 点击密钥。
3. 依次点击添加密钥和创建新密钥。

4. 点击创建。JSON 密钥文件将下载到您的计算机上。

   务必要安全存储密钥文件，因为它能够以服务账号的身份进行身份验证。您可以根据需要移动并重命名此文件。

5. 点击关闭。

您可以在“服务账号”页面中删除和创建私钥文件。

第 3 步：为转销商网域授权服务账号

您需要在本部分提供服务账号的客户端 ID。在 操作菜单中，选择管理详细信息，然后复制您的唯一 ID。

使用转销商网域的超级用户账号前往“全网域授权”页面。

• 点击新增，然后在客户端 ID 字段中输入服务账号的 ID。
• 在 OAuth 范围字段中输入 https://www.googleapis.com/auth/apps.order。
• 点击授权，允许您的服务账号在您的渠道服务账号上下文中使用 Cloud Channel API。

注意 ：如果您在最终集成中使用了其他 API，则服务账号的客户端可能具有多个范围。

然后，点击授权，以便您的服务账号可以在您的渠道服务账号上下文中使用 Cloud Channel API。

注意 ：在其他 Codelab 中，您可能需要启用更多 API 并添加更多镜重。最终集成可能为服务账号的客户端提供多个范围。

后续步骤

现在，您已经完成了初步的技术集成，接下来可以通过阅读 Cloud Channel API 文档来探索该 API。

注意 ：如果您还有一个测试合作伙伴销售控制台，请使用测试转销商网域按照第 1 步至第 4 步操作。请务必创建一个单独的项目，因为 Google API 具有按项目配额。在不同环境中共享项目可能会导致您的测试账号影响正式账号的配额。