NET.start للمورِّدين

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

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

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

  • حساب Google، وهو عضو في حساب المورّد المخصّص لبرنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" إذا لم تكن قد بدأت عملية الإعداد بعد، اتّبِع الخطوات الواردة في قسم البدء في دليل بوابة المورّدين.
  • ‫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.
  1. افتح بوابة "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة". وقد تحتاج إلى تسجيل الدخول.
  2. انقر على حسابات الخدمة.
  3. انقر على ربط حساب الخدمة.
  4. اضبط عنوان البريد الإلكتروني على عنوان حساب الخدمة الذي أنشأته.
  5. انقر على ربط حساب الخدمة لاستخدام حساب الخدمة مع حساب التسجيل باستخدام ميزة "إعداد الجهاز تلقائيًا" .

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

  1. أنشئ مشروعًا جديدًا من نوع تطبيق وحدة تحكّم باستخدام لغة C# وإطار عمل ‎.NET Core في 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");
            }
        }
    }
}

رقم تعريف الشريك

تتطلّب طلبات البيانات من واجهة برمجة التطبيقات عادةً معرّف شريك المورِّد كوسيطة. للعثور على رقم تعريف الشريك من بوابة "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة"، يمكنك اتّباع الخطوات التالية:

  1. افتح البوابة. وقد تحتاج إلى تسجيل الدخول.
  2. انقر على حسابات الخدمة.
  3. انسخ رقم تعريف الشريك من سطر رقم تعريف المورِّد.

الخطوة 5: تشغيل النموذج

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

تحديد المشاكل وحلّها

أخبِرنا بالمشكلة التي واجهتك في الخطوات السريعة وسنعمل على حلّها. لمعرفة كيفية استخدام ميزة "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" لحسابات الخدمة من أجل تفويض طلبات البيانات من واجهات برمجة التطبيقات، يُرجى الاطّلاع على مقالة التفويض.

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