اتّبِع الخطوات الواردة في دليل البدء السريع هذا، وفي غضون 10 دقائق تقريبًا، يتوفّر لديك تطبيق بسيط يستخدم وحدة تحكُّم #NET C# لتقديم طلبات إلى واجهة برمجة التطبيقات لعميل "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" باستخدام حساب خدمة.
المتطلبات الأساسية
لتنفيذ دليل البدء السريع هذا، ستحتاج إلى ما يلي:
- حساب خدمة مرتبط بحساب عميل إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة. يمكنك الاطّلاع على البدء.
- إصدار Visual Studio 2013 أو إصدار أحدث.
- إمكانية الوصول إلى الإنترنت ومتصفح الويب
الخطوة 1: تفعيل واجهة برمجة التطبيقات لبرنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة"
- يمكنك استخدام هذا المعالج لإنشاء مشروع أو اختياره في Google Play Console وتفعيل واجهة برمجة التطبيقات تلقائيًا. انقر على متابعة، ثم الانتقال إلى بيانات الاعتماد .
- اضبط ما هي البيانات التي ستصل إليها؟ على بيانات التطبيق.
- انقر على التالي. من المفترض أن يُطلب منك إنشاء حساب خدمة.
- أدخِل اسمًا وصفيًا لاسم حساب الخدمة.
- يُرجى ملاحظة رقم تعريف حساب الخدمة (يبدو أنه عنوان بريد إلكتروني) لأنك ستستخدمه لاحقًا.
- اضبط الدور على حسابات الخدمة > مستخدم حساب الخدمة.
- انقر على تم للانتهاء من إنشاء حساب الخدمة.
- انقر على عنوان البريد الإلكتروني لحساب الخدمة الذي أنشأته.
- انقر على **المفاتيح**.
- انقر على **إضافة مفتاح**، ثم انقر على **إنشاء مفتاح جديد**.
- في **نوع المفتاح**، اختَر **JSON**.
- انقر على Create (إنشاء) والمفتاح الخاص الذي تم تنزيله على جهاز الكمبيوتر.
- انقر على **إغلاق**.
- انقل الملف إلى دليل العمل وأعِد تسميته إلى
service_account_key.json
.
الخطوة 2: إعداد المشروع
- أنشِئ مشروعًا جديدًا في تطبيق Console يتضمّن بروتوكول NET Core C# في "الاستوديو المرئي".
- افتح "أداة إدارة الحِزم" واختَر مصدر الحزمة nuget.org، ثم أضِف
الحزم التالية:
Google.Apis.AndroidProvisioningPartner.v1
Google.Apis.Auth
لمعرفة المزيد من المعلومات، يُرجى الاطّلاع على مستند Microsoft تثبيت حزمة واستخدامها.
الخطوة 3: إعداد النموذج
- اسحب ملف
service_account_key.json
الذي نزّلته عند إنشاء حساب الخدمة إلى أداة Visual Studio Solution Explorer. - اختَر
service_account_key.json
، ثم انتقِل إلى نافذة الخصائص وانقر على الحقل نسخ إلى دليل الإخراج على دائمًا نسخ. - يُرجى استبدال محتوى
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
مع أي مستخدم. احرص على عدم تضمينها في مستودعات رموز المصدر. يمكنك الاطّلاع على مزيد من النصائح حول التعامل مع الأسرار المتعلقة بحسابات الخدمات.