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. أنشئ مشروع .NET Core C# Console Application الجديد في 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.

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

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

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