.NET quickstart for customers

Follow the steps in this quickstart guide, and in about 10 minutes you have a simple .NET C# console app that makes requests to the zero-touch enrollment customer API using a service account.

Prerequisites

To run this quickstart, you need:

A service account, that's linked to you zero-touch enrollment customer account. See Get started .
Visual Studio 2013 or later.
Access to the internet and a web browser.

Step 1: Turn on the zero-touch enrollment API

Use this wizard to create or select a project in the Google Developers Console and automatically turn on the API. Click Continue, then Go to credentials.
Set What data will you be accessing?to Application data .
Click Next. You should be prompted to create a service account.
Give a descriptive name for Service account name.
Note the Service account ID(it looks like an email address) because you'll use it later.
Set Roleto Service Accounts > Service Account User .
Click Doneto finish creating the service account.
Click the email address for the service account that you created.
Click **Keys**.
Click **Add key**, then click **Create new key**.
For **Key type**, select **JSON**.
Click Createand the private key downloads to your computer.
Click **Close**.
Move the file to your working directory and rename it service_account_key.json .

Step 2: Prepare the project

Create a new .NET Core C# Console Application project in Visual Studio.
Open the Package Manager, select the package source nuget.org, and add the following packages:
- Google.Apis.AndroidProvisioningPartner.v1
- Google.Apis.Auth

To learn more, read the Microsoft document Install and use a package .

Step 3: Set up the sample

Drag the service_account_key.json you downloaded when you created your service account into your Visual Studio Solution Explorer.
Select service_account_key.json , and then go to the Properties window and set Copy to output directoryfield to Always copy .
Replace the contents of Program.cs with the following code:

 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 
 ); 
  
 } 
  
 } 
  
 } 
 }

Step 4: Run the sample

To build and run the sample, click Startin the Visual Studio toolbar.

Notes

Avoid sharing your service_account_key.json file with anyone. Be careful not to include it in source code repositories. You can read more advice on handling service account secrets .