NET.start للبدء السريع للعملاء

اتّبِع الخطوات الواردة في دليل البدء السريع هذا، وستحصل في غضون 10 دقائق تقريبًا على تطبيق وحدة تحكّم بسيط بتنسيق ‎.NET C# يُرسل طلبات إلى واجهة برمجة التطبيقات لميزة "التسجيل بدون تلامس" للعملاء باستخدام حساب خدمة.

المتطلبات الأساسية

لتنفيذ هذه الخطوات السريعة، تحتاج إلى ما يلي:

  • حساب خدمة مرتبط بحساب العميل في برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" راجِع الحصول على البدء.
  • ‫Visual Studio 2013 أو إصدار أحدث
  • الوصول إلى الإنترنت ومتصفّح الويب

الخطوة 1: تفعيل واجهة برمجة التطبيقات لميزة "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة"

  1. استخدِم هذا معالج لإنشاء مشروع أو اختياره في Google Developers Console وتفعيل واجهة برمجة التطبيقات تلقائيًا. انقر على متابعة، ثم الانتقال إلى بيانات الاعتماد. .
  2. اضبط ما هي البيانات التي ستتمكّن من الوصول إليها؟ على بيانات التطبيق.
  3. انقر على التالي. سيُطلب منك إنشاء حساب خدمة.
  4. أدخِل اسمًا وصفيًا لـ اسم حساب الخدمة.
  5. دوِّن رقم تعريف حساب الخدمة (الذي يبدو مثل عنوان بريد إلكتروني) لأنك ستحتاج إلى لاستخدامه لاحقًا.
  6. اضبط الدور على حسابات الخدمة > مستخدم حساب الخدمة.
  7. انقر على تم لإنهاء إنشاء حساب الخدمة.
  8. انقر على عنوان البريد الإلكتروني لحساب الخدمة الذي أنشأته.
  9. انقر على **المفاتيح**.
  10. انقر على **إضافة مفتاح**، ثم انقر على **إنشاء مفتاح جديد**.
  11. بالنسبة إلى **نوع المفتاح**، اختَر **JSON**.
  12. انقر على إنشاء وسيتم تنزيل المفتاح الخاص على جهاز الكمبيوتر.
  13. انقر على **إغلاق**.
  14. انقل الملف إلى دليل العمل وأعِد تسميته service_account_key.json.

الخطوة 2: إعداد المشروع

  1. أنشئ مشروعًا جديدًا من نوع تطبيق وحدة تحكّم باستخدام لغة C# وإطار عمل ‎.NET Core في Visual Studio.
  2. افتح "مدير الحِزم"، واختَر مصدر الحِزم nuget.org، وأضِف الحِزم التالية:
    • Google.Apis.AndroidProvisioningPartner.v1
    • Google.Apis.Auth

لمزيد من المعلومات، يُرجى الاطّلاع على مستند Microsoft تثبيت ملف برمجي واستخدامه.

الخطوة 3: إعداد العيّنة

  1. اسحب ملف service_account_key.json الذي تم تنزيله عند إنشاء الجديدة إلى أداة Visual Studio Solution Explorer.
  2. اختَر "service_account_key.json"، ثم انتقِل إلى نافذة "الخصائص" اضبط الحقل نسخ إلى دليل الإخراج على النسخ دائمًا.
  3. استبدِل محتويات Program.cs بالرمز التالي:
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);
            }

        }
    }
}

الخطوة 4: تشغيل العيّنة

لإنشاء النموذج وتشغيله، انقر على رمز البدء في شريط أدوات Visual Studio.

ملاحظات

  • تجنب مشاركة ملف service_account_key.json مع أي شخص. تنبيه وعدم تضمينه في مستودعات رمز المصدر يمكنك قراءة المزيد من النصائح على التعامل مع أسرار حساب الخدمة.

مزيد من المعلومات