Hướng dẫn bắt đầu nhanh về .NET cho khách hàng
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Hãy làm theo các bước trong hướng dẫn bắt đầu nhanh này và sau khoảng 10 phút, bạn sẽ
một ứng dụng bảng điều khiển .NET C# đơn giản giúp đưa ra các yêu cầu thiết lập tự động
API của khách hàng.
Điều kiện tiên quyết
Để chạy quy trình bắt đầu nhanh này, bạn cần:
- Tài khoản Google là thành viên của khách hàng thiết lập tự động
tài khoản. Xem phần Khách hàng
tài khoản.
- Visual Studio 2013 trở lên.
- Truy cập vào Internet và trình duyệt web.
Bước 1: Bật API thiết lập tự động
- Sử dụng này
để tạo hoặc chọn dự án trong Google Developers Console và
tự động bật API. Nhấp vào Tiếp tục, sau đó nhấp vào Chuyển đến phần thông tin đăng nhập
- Nhấp vào Huỷ trên phần Tạo thông tin xác thực.
- Ở đầu trang, hãy chọn thẻ Màn hình xin phép bằng OAuth. Chọn một
Địa chỉ email, nhập Tên sản phẩm nếu chưa đặt và
nhấp vào nút Lưu.
- Chọn thẻ Credentials (Thông tin xác thực), nhấp vào Create credentials (Tạo thông tin xác thực)
rồi chọn Mã ứng dụng khách OAuth.
- Chọn loại ứng dụng Khác, rồi nhập tên
"Bắt đầu nhanh" rồi nhấp vào nút Tạo
.
- Nhấp vào OK để đóng bảng điều khiển ứng dụng OAuth.
- Nhấp vào file_download Tải tệp JSON xuống.
- Di chuyển tệp vào thư mục đang làm việc rồi đổi tên tệp
client_secret.json.
Bước 2: Chuẩn bị dự án
- Tạo một dự án .NET Core C# Ứng dụng bảng điều khiển C# trong Visual Studio.
- Mở Package Manager (Trình quản lý gói), chọn nguồn gói nuget.org rồi thêm
các gói sau:
Google.Apis.AndroidProvisioningPartner.v1Google.Apis.Auth
Để tìm hiểu thêm, hãy đọc tài liệu Cài đặt và sử dụng
gói.
Bước 3: Thiết lập mẫu
- Kéo
client_secret.json (được tải xuống ở Bước 1) vào Visual Studio
Trình khám phá giải pháp.
- Chọn
client_secret.json, sau đó chuyển đến cửa sổ Properties (Thuộc tính) rồi đặt
Trường Sao chép vào thư mục đầu ra vào trường Luôn sao chép.
- Thay thế nội dung của
Program.cs bằng đoạn mã sau:
using Google.Apis.AndroidProvisioningPartner.v1;
using Google.Apis.AndroidProvisioningPartner.v1.Data;
using Google.Apis.Auth.OAuth2;
using Google.Apis.Services;
using Google.Apis.Util.Store;
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)
{
UserCredential credential;
// Ask the user to authorize the request using their Google Account
// in their browser.
using (var stream =
new FileStream("client_secret.json", FileMode.Open, FileAccess.Read))
{
string credPath = System.Environment.GetFolderPath(
System.Environment.SpecialFolder.Personal);
credPath = Path.Combine(credPath, ".credentials/zero-touch.quickstart.json");
credential = GoogleWebAuthorizationBroker.AuthorizeAsync(
GoogleClientSecrets.FromStream(stream).Secrets,
Scopes,
"user",
CancellationToken.None,
new FileDataStore(credPath, true)).Result;
Console.WriteLine("Credential file saved to: " + credPath);
}
// 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);
}
}
}
}
Bước 4: Chạy mẫu
Để tạo và chạy mẫu, hãy nhấp vào biểu tượng play_arrow
Start (Bắt đầu) trên thanh công cụ Visual Studio.
Trong lần đầu chạy ứng dụng, bạn cần cấp quyền truy cập:
- Ứng dụng sẽ cố gắng mở một thẻ mới trong trình duyệt mặc định của bạn. Nếu thao tác này không thành công, hãy sao chép URL từ
bảng điều khiển và mở bảng điều khiển đó trong trình duyệt của bạn. Nếu chưa đăng nhập vào Tài khoản Google, bạn
được nhắc đăng nhập. Nếu bạn đã đăng nhập vào nhiều Tài khoản Google, trang này sẽ nhắc bạn chọn
một tài khoản cho lệnh uỷ quyền.
- Nhấp vào Chấp nhận.
- Đóng thẻ trình duyệt, ứng dụng sẽ tiếp tục chạy.
Ghi chú
- Vì thư viện ứng dụng API của Google lưu trữ dữ liệu uỷ quyền trên hệ thống tệp, nên
các lần chạy ứng dụng không nhắc bạn về việc uỷ quyền.
- Để đặt lại dữ liệu uỷ quyền của ứng dụng, hãy xoá
~/.credentials/zero-touch.quickstart.json rồi chạy lại ứng dụng.
- Quy trình uỷ quyền trong phần khởi động nhanh này là lựa chọn lý tưởng cho ứng dụng dòng lệnh. Để tìm hiểu cách thêm
cho phép một ứng dụng web, hãy xem
Dùng OAuth 2.0, Ứng dụng web (ASP.NET MVC).
Khắc phục sự cố
Dưới đây là một số điểm phổ biến mà bạn nên kiểm tra.
Hãy cho chúng tôi biết lỗi bằng tính năng bắt đầu nhanh và chúng tôi sẽ tìm cách khắc phục.
- Kiểm tra để chắc chắn rằng bạn đang cho phép thực hiện lệnh gọi API bằng cùng một Tài khoản Google là thành viên của
tài khoản khách hàng thiết lập tự động. Hãy thử đăng nhập vào cổng thiết lập tự động bằng
cùng một Tài khoản Google để kiểm tra quyền truy cập.
- Xác nhận rằng tài khoản đã chấp nhận Điều khoản dịch vụ mới nhất trong
cổng dịch vụ. Xem
Tài khoản khách hàng.
Tìm hiểu thêm
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-29 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[[["\u003cp\u003eThis quickstart guide helps you create a .NET C# console application that interacts with the zero-touch enrollment customer API in approximately 10 minutes.\u003c/p\u003e\n"],["\u003cp\u003eTo begin, you'll need a Google account linked to your zero-touch enrollment customer account, Visual Studio 2013 or later, and internet access.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves enabling the zero-touch enrollment API in the Google Developers Console, preparing a new .NET Core C# project with specific NuGet packages, and setting up the sample by downloading and configuring a \u003ccode\u003eclient_secret.json\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eRunning the sample requires authorizing the app to access your Google account, which may involve logging in and granting permissions via a browser.\u003c/p\u003e\n"],["\u003cp\u003eThe provided code fetches and lists the DPCs available to a customer's account using the zero-touch enrollment API.\u003c/p\u003e\n"]]],["This guide outlines creating a .NET C# console app that interacts with the zero-touch enrollment customer API. It involves enabling the API in the Google Developers Console, creating OAuth credentials, and downloading a `client_secret.json` file. The process continues by creating a .NET console application, adding necessary NuGet packages, and setting `client_secret.json` to copy to the output. The code authenticates a Google account, retrieves the customer's account, lists the available DPCs, and then displays their details. Finally, it offers instructions on running, authorizing, and troubleshooting the application.\n"],null,["# .NET quickstart for customers\n\nFollow the steps in this quickstart guide, and in about 10 minutes you have\na simple .NET C# console app that makes requests to the zero-touch enrollment\ncustomer API.\n\nPrerequisites\n-------------\n\nTo run this quickstart, you need:\n\n- A Google account, that's a member of your zero-touch enrollment customer account. See [Customer\n accounts](/zero-touch/guides/customer/auth#customer_accounts).\n- Visual Studio 2013 or later.\n- Access to the internet and a web browser.\n\nStep 1: Turn on the zero-touch enrollment API\n---------------------------------------------\n\n1. Use [this\n wizard](https://console.developers.google.com/start/api?id=androiddeviceprovisioning.googleapis.com) to create or select a project in the Google Developers Console and automatically turn on the API. Click **Continue** , then **Go to credentials**.\n2. Click **Cancel** on the Create credentials.\n3. At the top of the page, select the **OAuth consent screen** tab. Select an **Email address** , enter a **Product name** if not already set, and click the **Save** button.\n4. Select the **Credentials** tab, click the **Create credentials** button and select **OAuth client ID**.\n5. Select the application type **Other** , enter the name \"Quickstart\", and click the **Create** button.\n6. Click **OK** to dismiss the *OAuth client* panel.\n7. Click file_download **Download JSON**.\n8. Move the file to your working directory and rename it `client_secret.json`.\n\nStep 2: Prepare the project\n---------------------------\n\n1. Create a new .NET Core C# *Console Application* project in Visual Studio.\n2. Open the Package Manager, select the package source **nuget.org** , and add the following packages:\n - `Google.Apis.AndroidProvisioningPartner.v1`\n - `Google.Apis.Auth`\n\nTo learn more, read the Microsoft document [Install and use a\npackage](https://docs.microsoft.com/en-us/nuget/quickstart/use-a-package).\n\nStep 3: Set up the sample\n-------------------------\n\n1. Drag `client_secret.json` (downloaded in Step 1) into your Visual Studio Solution Explorer.\n2. Select `client_secret.json`, and then go to the Properties window and set **Copy to output directory** field to *Always copy*.\n3. Replace the contents of `Program.cs` with the following code:\n\n```c#\nusing Google.Apis.AndroidProvisioningPartner.v1;\nusing Google.Apis.AndroidProvisioningPartner.v1.Data;\nusing Google.Apis.Auth.OAuth2;\nusing Google.Apis.Services;\nusing Google.Apis.Util.Store;\nusing System;\nusing System.Collections.Generic;\nusing System.IO;\nusing System.Threading;\n\nnamespace ZeroTouchCustomerQuickstart\n{\n class Program\n {\n // A single scope is used for the zero-touch enrollment customer API.\n static readonly string[] Scopes =\n { \"https://www.googleapis.com/auth/androidworkzerotouchemm\" };\n static string ApplicationName = \"Zero-touch Enrollment .NET Quickstart\";\n\n static void Main(string[] args)\n {\n UserCredential credential;\n\n // Ask the user to authorize the request using their Google Account\n // in their browser.\n using (var stream =\n new FileStream(\"client_secret.json\", FileMode.Open, FileAccess.Read))\n {\n string credPath = System.Environment.GetFolderPath(\n System.Environment.SpecialFolder.Personal);\n credPath = Path.Combine(credPath, \".credentials/zero-touch.quickstart.json\");\n\n credential = GoogleWebAuthorizationBroker.AuthorizeAsync(\n GoogleClientSecrets.FromStream(stream).Secrets,\n Scopes,\n \"user\",\n CancellationToken.None,\n new FileDataStore(credPath, true)).Result;\n Console.WriteLine(\"Credential file saved to: \" + credPath);\n }\n\n // Create a zero-touch enrollment API service endpoint.\n var service = new AndroidProvisioningPartnerService(new BaseClientService.Initializer\n {\n HttpClientInitializer = credential,\n ApplicationName = ApplicationName\n });\n\n // Get the customer's account. Because a customer might have more\n // than one, limit the results to the first account found.\n CustomersResource.ListRequest accountRequest = service.Customers.List();\n accountRequest.PageSize = 1;\n CustomerListCustomersResponse accountResponse = accountRequest.Execute();\n if (accountResponse.Customers.Count == 0)\n {\n // No accounts found for the user. Confirm the Google Account\n // that authorizes the request can access the zero-touch portal.\n Console.WriteLine(\"No zero-touch enrollment account found.\");\n Environment.Exit(-1);\n }\n Company customer = accountResponse.Customers[0];\n var customerAccount = String.Format(\"customers/{0}\", customer.CompanyId);\n\n\n // Send an API request to list all the DPCs available.\n CustomersResource.DpcsResource.ListRequest request = service.Customers.Dpcs.\n List(customerAccount);\n CustomerListDpcsResponse response = request.Execute();\n\n // Print out the details of each DPC.\n IList\u003cDpc\u003e dpcs = response.Dpcs;\n foreach (Dpc dpcApp in dpcs)\n {\n Console.WriteLine(\"Name:{0} APK:{1}\",\n dpcApp.DpcName,\n dpcApp.PackageName);\n }\n\n }\n }\n}\n```\n\nStep 4: Run the sample\n----------------------\n\nTo build and run the sample, click play_arrow **Start** in the Visual Studio toolbar.\n\nThe first time you run the app, you need to authorize access:\n\n1. The app tries to open a new tab in your default browser. If this fails, copy the URL from the console and open it in your browser. If you're not already logged into your Google Account, you're prompted to log in. If you're logged into multiple Google accounts, the page prompts you to select an account for the authorization.\n2. Click **Accept**.\n3. Close the browser tab---the app continues running.\n\nNotes\n-----\n\n- Because Google API client library stores authorization data on the file system, subsequent launches don't prompt you for authorization.\n- To reset the app's authorization data, delete the `~/.credentials/zero-touch.quickstart.json` file and run the app again.\n- The authorization flow in this quickstart is ideal for a command-line app. To learn how to add authorization to a web app, see [Using OAuth 2.0, Web applications (ASP.NET MVC)](/api-client-library/dotnet/guide/aaa_oauth#web-applications-aspnet-mvc).\n\nTroubleshooting\n---------------\n\nHere are some common things you'll want to check.\n[Tell us what went wrong]() with the quickstart and we'll work to fix it.\n\n- Check that you're authorizing API calls with the same Google Account that's a member of your zero-touch enrollment customer account. Try signing in to the zero-touch enrollment [portal](https://enterprise.google.com/android/zero-touch/resellers) using the same Google Account to test your access.\n- Confirm that the account has accepted the latest Terms of Service in the [portal](https://enterprise.google.com/android/zero-touch/resellers). See [Customer accounts](/zero-touch/guides/customer/auth#customer_accounts).\n\nLearn more\n----------\n\n- [Google Developers Console help documentation](/console/help/new)\n- [Google API Client Library for .NET\n documentation](/api-client-library/dotnet)"]]
