การเริ่มต้นอย่างรวดเร็ว .NET สำหรับตัวแทนจำหน่าย

ทำตามขั้นตอนในคำแนะนำในการเริ่มต้นใช้งานฉบับย่อนี้ และคุณจะมีแอปคอนโซล .NET C# ง่ายๆ ที่ส่งคำขอไปยัง API ตัวแทนจำหน่ายสำหรับการลงทะเบียนแบบรวมศูนย์ในอีกประมาณ 10 นาที

ข้อกำหนดเบื้องต้น

คุณต้องมีสิ่งต่อไปนี้เพื่อเรียกใช้การเริ่มต้นอย่างรวดเร็วนี้

  • บัญชี Google ที่เป็นสมาชิกของบัญชีตัวแทนจำหน่ายการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม หากยังไม่ได้เริ่มต้นใช้งาน ให้ทำตามขั้นตอนในเริ่มต้นใช้งานในคู่มือพอร์ทัลตัวแทนจำหน่าย
  • Visual Studio 2013 ขึ้นไป
  • อินเทอร์เน็ตและเว็บเบราว์เซอร์

ขั้นตอนที่ 1: เปิด API การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม

  1. ใช้วิซาร์ดนี้เพื่อสร้างหรือเลือกโปรเจ็กต์ใน Google Developers Console และเปิด API โดยอัตโนมัติ คลิกต่อไป แล้วคลิกไปที่ข้อมูลเข้าสู่ระบบ
  2. ตั้งค่าคุณต้องการเข้าถึงข้อมูลใดเป็นข้อมูลแอปพลิเคชัน
  3. คลิกถัดไป คุณควรได้รับแจ้งให้สร้างบัญชีบริการ
  4. ตั้งชื่อที่สื่อความหมายสำหรับชื่อบัญชีบริการ
  5. จดบันทึกรหัสบัญชีบริการ (มีลักษณะคล้ายอีเมล) เนื่องจากคุณจะต้องใช้รหัสนี้ในภายหลัง
  6. ตั้งค่าบทบาทเป็นบัญชีบริการ > ผู้ใช้บัญชีบริการ
  7. คลิกเสร็จสิ้นเพื่อสร้างบัญชีบริการให้เสร็จสมบูรณ์
  8. คลิกอีเมลของบัญชีบริการที่คุณสร้างขึ้น
  9. คลิก**กุญแจ**
  10. คลิก**เพิ่มคีย์** แล้วคลิก**สร้างคีย์ใหม่**
  11. เลือก **JSON** สำหรับ**ประเภทคีย์**
  12. คลิกสร้าง แล้วคีย์ส่วนตัวจะดาวน์โหลดลงในคอมพิวเตอร์
  13. คลิก **ปิด**
  14. ย้ายไฟล์ไปยังไดเรกทอรีทํางาน แล้วเปลี่ยนชื่อเป็น service_account_key.json
  1. เปิดพอร์ทัลการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม คุณอาจต้องลงชื่อเข้าใช้
  2. คลิก บัญชีบริการ
  3. คลิก ลิงก์บัญชีบริการ
  4. ตั้งค่าอีเมลเป็นอีเมลของบัญชีบริการที่คุณสร้างขึ้น
  5. คลิกลิงก์บัญชีบริการเพื่อใช้บัญชีบริการกับบัญชีลงทะเบียนการตั้งค่าอุปกรณ์พร้อมใช้

ขั้นตอนที่ 3: เตรียมโปรเจ็กต์

  1. สร้างโปรเจ็กต์แอปพลิเคชันคอนโซล .NET Core C# ใหม่ใน Visual Studio
  2. เปิดตัวจัดการแพ็กเกจ เลือกแหล่งที่มาของแพ็กเกจ nuget.org แล้วเพิ่มแพ็กเกจต่อไปนี้
    • Google.Apis.AndroidProvisioningPartner.v1
    • Google.Apis.Auth

อ่านข้อมูลเพิ่มเติมได้ในเอกสารของ Microsoft หัวข้อติดตั้งและใช้แพ็กเกจ

ขั้นตอนที่ 4: ตั้งค่าตัวอย่าง

  1. ลาก service_account_key.json (ที่ดาวน์โหลดในขั้นตอนที่ 1) ไปยัง Visual Studio Solution Explorer
  2. เลือก service_account_key.json จากนั้นไปที่หน้าต่างพร็อพเพอร์ตี้ แล้วตั้งค่าช่องคัดลอกไปยังไดเรกทอรีเอาต์พุตเป็นคัดลอกเสมอ
  3. แทนที่เนื้อหาของ Program.cs ด้วยโค้ดต่อไปนี้
  4. แทรกรหัสพาร์ทเนอร์ตัวแทนจําหน่ายของคุณเองเป็นค่าสําหรับ 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 ต้องใช้รหัสพาร์ทเนอร์ตัวแทนจำหน่ายของคุณเป็นอาร์กิวเมนต์ หากต้องการค้นหารหัสพาร์ทเนอร์จากพอร์ทัลการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม ให้ทำตามขั้นตอนด้านล่าง

  1. เปิดพอร์ทัล คุณอาจต้องลงชื่อเข้าใช้
  2. คลิก บัญชีบริการ
  3. คัดลอกหมายเลขรหัสพาร์ทเนอร์จากบรรทัดรหัสตัวแทนจำหน่ายของคุณ

ขั้นตอนที่ 5: เรียกใช้ตัวอย่าง

หากต้องการสร้างและเรียกใช้ตัวอย่าง ให้คลิก Start ในแถบเครื่องมือ Visual Studio

การแก้ปัญหา

บอกเราเกี่ยวกับปัญหาที่เกิดขึ้นกับวิธีเริ่มต้นใช้งานด่วน แล้วเราจะพยายามแก้ไข หากต้องการดูวิธีที่การตั้งค่าอุปกรณ์พร้อมใช้ใช้บัญชีบริการเพื่อให้สิทธิ์การเรียก API โปรดอ่านการให้สิทธิ์

ดูข้อมูลเพิ่มเติม