دليل البدء السريع لاستخدام Python للمورّدين

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

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

لتنفيذ هذا التشغيل السريع، ستحتاج إلى:

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

الخطوة 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: تثبيت مكتبة برامج Google

شغّل الأمر التالي لتثبيت المكتبة باستخدام pip:

pip install --upgrade google-api-python-client

اطلع على صفحة تثبيت المكتبة للحصول على خيارات تثبيت مختلفة.

الخطوة 4: إعداد النموذج

أنشئ ملفًا باسم quickstart.py في دليل العمل. انسخ الرمز التالي واحفظ الملف. أدرِج رقم تعريف الشريك للمورّد كقيمة لـ PARTNER_ID (السطر الأول من التطبيق بعد عمليات الاستيراد).

#!/usr/bin/env python
# -*- coding: utf-8 -*-
"""Zero-touch enrollment reseller quickstart.

This script forms the quickstart introduction to the zero-touch enrollemnt
reseller API. To learn more, visit https://developer.google.com/zero-touch
"""

from apiclient.discovery import build
from httplib2 import Http
from oauth2client.service_account import ServiceAccountCredentials

# TODO: replace this with your partner reseller ID.
PARTNER_ID = '11036885';

# A single auth scope is used for the zero-touch enrollment customer API.
SCOPES = ['https://www.googleapis.com/auth/androidworkprovisioning']
SERVICE_ACCOUNT_KEY_FILE = 'service_account_key.json'

def get_credential():
  """Creates a Credential object with the correct OAuth2 authorization.

  Creates a Credential object with the correct OAuth2 authorization
  for the service account that calls the reseller API. The service
  endpoint calls this method when setting up a new service instance.

  Returns:
    Credential, the user's credential.
  """
  credential = ServiceAccountCredentials.from_json_keyfile_name(
      SERVICE_ACCOUNT_KEY_FILE, scopes=SCOPES)
  return credential


def get_service():
  """Creates a service endpoint for the zero-touch enrollment reseller API.

  Builds and returns an authorized API client service for v1 of the API. Use
  the service endpoint to call the API methods.

  Returns:
    A service Resource object with methods for interacting with the service.
  """
  http_auth = get_credential().authorize(Http())
  service = build('androiddeviceprovisioning', 'v1', http=http_auth)
  return service


def main():
  """Runs the zero-touch enrollment quickstart app.
  """
  # Create a zero-touch enrollment API service endpoint.
  service = get_service()

  # Send an API request to list all our customers.
  response = service.partners().customers().list(partnerId=PARTNER_ID).execute()

  # Print out the details of each customer.
  if 'customers' in response:
    for customer in response['customers']:
      print 'Name:{0}  ID:{1}'.format(
          customer['companyName'], customer['companyId'])
  else:
    print 'No customers found'


if __name__ == '__main__':
  main()

معرِّف الشريك

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

  1. افتح البوابة. وقد تحتاج تسجيل الدخول.
  2. انقر على حسابات الخدمة.
  3. انسخ رقم تعريف الشريك من السطر رقم تعريف المورّد.

الخطوة الخامسة: تنفيذ النموذج

استخدم مساعدة نظام التشغيل لتشغيل النص البرمجي في الملف. على أجهزة الكمبيوتر التي تعمل بنظامي التشغيل UNIX وMac، شغّل الأمر أدناه في الوحدة الطرفية:

python quickstart.py

طباعة استجابات واجهة برمجة التطبيقات

لتسهيل فحص الردود عند تجربة واجهة برمجة التطبيقات، يمكنك تنسيق بيانات استجابة JSON. يعرض المقتطف أدناه كيفية إجراء ذلك في Python باستخدام وحدة JSON:

from json import dumps

# ...

results = provisioning.partners().devices().claimAsync(partnerId=MY_PARTNER_ID,
 body={'claims':new_claims}).execute()
# Print formatted JSON response
print dumps(results, indent=4, sort_keys=True)

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

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

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