لمحة سريعة للعملاء حول NET.

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

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

لتنفيذ دليل البدء السريع هذا، ستحتاج إلى ما يلي:

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

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

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

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

  1. أنشِئ مشروعًا جديدًا في تطبيق Console يتضمّن بروتوكول NET Core C# في "الاستوديو المرئي".
  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.

ملاحظات

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