面向转销商的 .NET 快速入门

按照本快速入门指南中的步骤操作，在大约 10 分钟内，您将获得一个简单的 .NET C# 控制台应用，该应用可向零触摸注册转销商 API 发出请求。

前提条件

如需运行本快速入门，您需要满足以下条件：

  • 一个 Google 账号，该账号是您的“零触摸注册”转销商账号的成员。如果您尚未完成新手入门流程，请按照转销商门户指南中的使用入门部分中的步骤操作。
  • Visual Studio 2013 或更高版本。
  • 能够连接到互联网并使用网络浏览器。

第 1 步：启用零触摸注册 API

  1. 使用此向导在 Google Developers Console 中创建或选择项目，并自动启用该 API。点击继续，然后点击转到凭据。
  2. 将您要访问哪些数据？设置为应用数据。
  3. 点击下一步。系统应该会提示您创建服务账号。
  4. 为服务账号名称提供一个描述性名称。
  5. 记下服务账号 ID（看起来像电子邮件地址），因为您稍后将用到它。
  6. 将角色设置为 Service Accounts > Service Account User。
  7. 点击完成以完成服务账号的创建过程。
  8. 点击您创建的服务账号的电子邮件地址。
  9. 点击**密钥**。
  10. 点击**添加密钥**，然后点击**创建新密钥**。
  11. 在“密钥类型”中，选择“JSON”。
  12. 点击创建，私钥便会下载到您的计算机。
  13. 点击“关闭”。
  14. 将该文件移至您的工作目录中，并将其重命名为 service_account_key.json。
  1. 打开零触摸注册门户。您可能需要登录。
  2. 点击 服务账号。
  3. 点击 关联服务账号。
  4. 将电子邮件地址设置为您创建的服务账号的地址。
  5. 点击关联服务账号，将服务账号与零触摸注册账号搭配使用。

第 3 步：准备项目

  1. 在 Visual Studio 中创建一个新的 .NET Core C# 控制台应用项目。
  2. 打开软件包管理器，选择软件包来源 nuget.org，然后添加以下软件包：
    • Google.Apis.AndroidProvisioningPartner.v1
    • Google.Apis.Auth

如需了解详情，请参阅 Microsoft 文档安装和使用软件包。

第 4 步：设置示例

  1. 将第 1 步中下载的 service_account_key.json 拖动到 Visual Studio Solution Explorer 中。
  2. 选择 service_account_key.json，然后前往“Properties”（属性）窗口，将 Copy to output directory（复制到输出目录）字段设置为 Always copy（始终复制）。
  3. 将 Program.cs 的内容替换为以下代码。
  4. 插入您自己的转销商合作伙伴 ID 作为 PartnerId（应用的第一行）的值。
using Google.Apis.AndroidProvisioningPartner.v1;
using Google.Apis.AndroidProvisioningPartner.v1.Data;
using Google.Apis.Auth.OAuth2;
using Google.Apis.Services;
using System;
using System.Collections.Generic;
using System.IO;

namespace ZeroTouchResellerQuickstart
{
    class Program
    {
        // TODO: replace this with your partner reseller ID.
        static long PartnerId = 11036885;

        // Use a single scope for the all methods in the reseller API.
        static readonly string[] Scopes =
        { "https://www.googleapis.com/auth/androidworkprovisioning" };
        static string ApplicationName = "Zero-touch Reseller .NET Quickstart";

        static void Main(string[] args)
        {
            // Create a credential to authorize API requests using a service account key.
            // The service account must be linked using the zero-touch portal.
            ServiceAccountCredential credential;
            using (var stream =
                new FileStream("service_account_key.json", FileMode.Open, FileAccess.Read))
            {
                credential = GoogleCredential.FromStream(stream)
                                     .CreateScoped(Scopes)
                                     .UnderlyingCredential as ServiceAccountCredential;
            }

            // Create a zero-touch enrollment API service endpoint.
            var service = new AndroidProvisioningPartnerService(new BaseClientService.Initializer
            {
                HttpClientInitializer = credential,
                ApplicationName = ApplicationName
            });

            // Send an API request to list all our customers.
            PartnersResource.CustomersResource.ListRequest request =
                service.Partners.Customers.List(PartnerId);
            ListCustomersResponse response = request.Execute();

            // Print out the details of each customer.
            IList<Company> customers = response.Customers;
            if (customers != null)
            {
                foreach (Company customer in customers)
                {
                    Console.WriteLine("Name:{0}  ID:{1}",
                                      customer.CompanyName,
                                      customer.CompanyId);
                }
            }
            else
            {
                Console.WriteLine("No customers found");
            }
        }
    }
}

合作伙伴 ID

API 调用通常需要将您的转销商合作伙伴 ID 作为参数。如需在零触摸注册门户网站中查找您的合作伙伴 ID，请按以下步骤操作：

  1. 打开门户网站。您可能需要登录。
  2. 点击 服务账号。
  3. 复制您的转销商 ID 行中的合作伙伴 ID。

第 5 步：运行示例

如需构建并运行示例，请点击 Visual Studio 工具栏中的 Start。

问题排查

告诉我们快速入门出现了什么问题，我们会努力解决。如需了解零触摸如何使用服务账号授权 API 调用，请参阅授权。

了解详情