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. أنشئ مشروع .NET Core C# Console Application الجديد في 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 مع أي مستخدم. تنبيه وعدم تضمينه في مستودعات رمز المصدر يمكنك قراءة المزيد من النصائح على التعامل مع أسرار حساب الخدمة.

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