面向客户的 .NET 快速入门

按照本快速入门指南中的步骤操作，在大约 10 分钟内 一个简单的 .NET C# 控制台应用，用于请求零触摸注册 Customer API。

前提条件

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

  • 一个服务账号，该账号与您的“零触摸注册”客户账号相关联。请参阅获取 开始。
  • Visual Studio 2013 或更高版本。
  • 能够访问互联网和网络浏览器。

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

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

第 2 步：准备项目

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

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

第 3 步：设置示例

  1. 将您在创建 API 密钥时下载的service_account_key.json 服务账号导入您的 Visual Studio Solution Explorer。
  2. 选择 service_account_key.json，然后转到“Properties”（属性）窗口 将 Copy to output directory 字段设为 Always copy。
  3. 将 Program.cs 的内容替换为以下代码：
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;
using System.Threading;

namespace ZeroTouchCustomerQuickstart
{
    class Program
    {
        // A single scope is used for the zero-touch enrollment customer API.
        static readonly string[] Scopes =
            { "https://www.googleapis.com/auth/androidworkzerotouchemm" };
        static string ApplicationName = "Zero-touch Enrollment .NET Quickstart";

        static void Main(string[] args)
        {
            GoogleCredential credential;

            // Authenticate using the service account key
            credential = GoogleCredential.FromFile("service_account_key.json")
                .CreateScoped(Scopes);

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

            // Get the customer's account. Because a customer might have more
            // than one, limit the results to the first account found.
            CustomersResource.ListRequest accountRequest = service.Customers.List();
            accountRequest.PageSize = 1;
            CustomerListCustomersResponse accountResponse = accountRequest.Execute();
            if (accountResponse.Customers.Count == 0)
            {
                // No accounts found for the user. Confirm the Google Account
                // that authorizes the request can access the zero-touch portal.
                Console.WriteLine("No zero-touch enrollment account found.");
                Environment.Exit(-1);
            }
            Company customer = accountResponse.Customers[0];
            var customerAccount = String.Format("customers/{0}", customer.CompanyId);


            // Send an API request to list all the DPCs available.
            CustomersResource.DpcsResource.ListRequest request = service.Customers.Dpcs.
                List(customerAccount);
            CustomerListDpcsResponse response = request.Execute();

            // Print out the details of each DPC.
            IList<Dpc> dpcs = response.Dpcs;
            foreach (Dpc dpcApp in dpcs)
            {
                Console.WriteLine("Name:{0}  APK:{1}",
                                  dpcApp.DpcName,
                                  dpcApp.PackageName);
            }

        }
    }
}

第 4 步：运行示例代码

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

备注

  • 避免与任何人分享您的 service_account_key.json 文件。请务必不要将其包含在源代码库中。您可以访问 处理服务账号密钥。

了解详情