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

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

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

لتشغيل هذا البدء السريع، ستحتاج إلى:

  • حساب 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) إلى الصورة المرئية. مستكشف الحلول في استوديو YouTube
  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.

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

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

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