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

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

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

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

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

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

  1. ใช้ this วิซาร์ดเพื่อสร้างหรือเลือกโปรเจ็กต์ใน 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. สร้างโปรเจ็กต์ Console Application ใหม่ใน Visual Studio โดยใช้ .NET Core C#
  2. เปิด Package Manager เลือกแหล่งที่มาของแพ็กเกจ 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 โปรดอ่านการให้สิทธิ์

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