ทำตามขั้นตอนในคู่มือเริ่มใช้งานฉบับย่อนี้ จากนั้นคุณจะ แอปคอนโซล .NET C# แบบเรียบง่ายที่ส่งคำขอไปยังการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม API ของตัวแทนจำหน่าย
ข้อกำหนดเบื้องต้น
คุณต้องมีสิ่งต่อไปนี้จึงจะเรียกใช้การเริ่มต้นใช้งานอย่างรวดเร็วนี้ได้
- บัญชี Google ที่เป็นสมาชิกของบัญชีตัวแทนจำหน่ายการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม หากยังไม่ได้เริ่มต้นใช้งาน ให้ทำตามขั้นตอนในส่วนเริ่มต้นใช้งานใน คู่มือพอร์ทัลผู้ค้าปลีก
- Visual Studio 2013 ขึ้นไป
- เข้าถึงอินเทอร์เน็ตและเว็บเบราว์เซอร์
ขั้นตอนที่ 1: เปิด API การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม
- ใช้ this วิซาร์ดเพื่อสร้างหรือเลือกโปรเจ็กต์ใน Google Developers Console และ เปิด API โดยอัตโนมัติ คลิกต่อไป แล้วคลิกไปที่ข้อมูลเข้าสู่ระบบ
- ตั้งค่าคุณจะเข้าถึงข้อมูลใดบ้างเป็นข้อมูลแอปพลิเคชัน
- คลิกถัดไป คุณควรได้รับแจ้งให้สร้างบริการ ของคุณได้
- ตั้งชื่อที่สื่อความหมายสำหรับชื่อบัญชีบริการ
- จดบันทึกรหัสบัญชีบริการ (มีลักษณะคล้ายอีเมล) เนื่องจากคุณจะต้องใช้รหัสนี้ในภายหลัง
- ตั้งค่าบทบาทเป็นบัญชีบริการ > ผู้ใช้บัญชีบริการ
- คลิกเสร็จสิ้นเพื่อสร้างบัญชีบริการให้เสร็จสิ้น
- คลิกอีเมลของบัญชีบริการที่คุณสร้างขึ้น
- คลิก**กุญแจ**
- คลิก**เพิ่มคีย์** แล้วคลิก**สร้างคีย์ใหม่**
- สำหรับ **ประเภทคีย์** ให้เลือก **JSON**
- คลิกสร้าง แล้วคีย์ส่วนตัวจะดาวน์โหลดลงในคอมพิวเตอร์
- คลิก **ปิด**
- ย้ายไฟล์ไปยังไดเรกทอรีที่ใช้งานอยู่และเปลี่ยนชื่อ
service_account_key.json
ขั้นตอนที่ 2: ลิงก์บัญชีบริการ
- เปิดพอร์ทัลการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม คุณอาจต้องลงชื่อเข้าใช้
- คลิก บัญชีบริการ
- คลิก ลิงก์บัญชีบริการ
- ตั้งค่าอีเมลเป็นที่อยู่ของบัญชีบริการที่คุณสร้างขึ้น
- คลิกลิงก์บัญชีบริการเพื่อใช้บัญชีบริการกับบัญชีลงทะเบียนการตั้งค่าอุปกรณ์พร้อมใช้
ขั้นตอนที่ 3: เตรียมโครงการ
- สร้างโปรเจ็กต์ Console Application ใหม่ใน Visual Studio โดยใช้ .NET Core C#
- เปิด Package Manager เลือกแหล่งที่มาของแพ็กเกจ nuget.org แล้วเพิ่มแพ็กเกจต่อไปนี้
Google.Apis.AndroidProvisioningPartner.v1
Google.Apis.Auth
หากต้องการดูข้อมูลเพิ่มเติม โปรดอ่านเอกสารของ Microsoft ที่หัวข้อติดตั้งและใช้ แพ็กเกจ
ขั้นตอนที่ 4: ตั้งค่าตัวอย่าง
- ลาก
service_account_key.json
(ที่ดาวน์โหลดในขั้นตอนที่ 1) ไปยัง Visual Studio Solution Explorer - เลือก
service_account_key.json
จากนั้นไปที่หน้าต่าง "คุณสมบัติ" และ ตั้งค่าช่องคัดลอกไปยังไดเรกทอรีเอาต์พุตเป็นคัดลอกเสมอ - แทนที่เนื้อหาของ
Program.cs
ด้วยรหัสต่อไปนี้ - แทรกรหัสพาร์ทเนอร์ตัวแทนจําหน่ายของคุณเองเป็นค่าสําหรับ
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"); } } } }
รหัสพาร์ทเนอร์
โดยทั่วไปแล้ว การเรียก API จะต้องใช้รหัสพาร์ทเนอร์ตัวแทนจำหน่ายของคุณเป็นอาร์กิวเมนต์ หากต้องการค้นหา รหัสพาร์ทเนอร์จากพอร์ทัลการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม ให้ทำตามขั้นตอนต่อไปนี้
- เปิดพอร์ทัล คุณอาจต้องลงชื่อเข้าใช้
- คลิก บริการ
- คัดลอกหมายเลขรหัสพาร์ทเนอร์จากบรรทัดรหัสตัวแทนจำหน่ายของคุณ
ขั้นตอนที่ 5: เรียกใช้ตัวอย่าง
หากต้องการสร้างและเรียกใช้ตัวอย่าง ให้คลิก
Start ในแถบเครื่องมือ Visual Studioการแก้ปัญหา
บอกเราว่าเกิดข้อผิดพลาดใดกับการเริ่มต้นอย่างรวดเร็ว และเราจะดำเนินการเพื่อ แก้ไข หากต้องการดูวิธีที่การตั้งค่าอุปกรณ์พร้อมใช้ใช้บัญชีบริการเพื่อให้สิทธิ์การเรียก API โปรดอ่านการให้สิทธิ์