המדריך למתחילים של Python למפיצים

פועלים לפי השלבים במדריך למתחילים, ותוך 10 דקות, אפליקציית שורת פקודה פשוטה ב-Python ששולחת בקשות דרך הארגון ממשק ה-API של מפיץ הרישום.

דרישות מוקדמות

כדי להפעיל את המדריך למתחילים הזה, צריך:

  • חשבון Google שהוא חבר במפיץ ההרשמה דרך הארגון שלך חשבון. אם עדיין לא הצטרפתם לתוכנית, צריך לפעול לפי השלבים שמפורטים בקטע שנתחיל? המדריך לפורטל המפיצים.
  • Python בגרסה 2.6 ומעלה.
  • הכלי לניהול חבילות pip.
  • גישה לאינטרנט ודפדפן אינטרנט.

שלב 1: מפעילים את ה-API להרשמה דרך הארגון

  1. אפשר להשתמש בקישור הזה באשף ליצירה או בחירה של פרויקט ב-Google Developers Console, להפעיל את ה-API באופן אוטומטי. לוחצים על המשך ואז על מעבר לפרטי הכניסה. .
  2. מגדירים את האפשרות אילו נתונים תיגש? לנתוני אפליקציה.
  3. לוחצים על הבא. אמורה להופיע בקשה ליצור שירות חשבון.
  4. נותנים לשם חשבון השירות שם תיאורי.
  5. שימו לב שמזהה חשבון השירות (הוא נראה כמו כתובת אימייל) כי להשתמש בה מאוחר יותר.
  6. מגדירים את Role ל-Service Accounts > Service Account User.
  7. לוחצים על Done כדי לסיים ליצור את חשבון השירות.
  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 בספריית העבודה. מעתיקים את את הקוד הבא ושומרים את הקובץ. הוספת שותף מפיץ משלך ID בתור הערך של 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()

מזהה השותף

בדרך כלל, צריך לציין את מזהה השותף המפיץ כארגומנטים בקריאות ל-API. כדי למצוא את מזהה השותף שנמצא בפורטל ההרשמה דרך הארגון, צריך לבצע את השלבים הבאים:

  1. פותחים את הפורטל. יכול להיות שתצטרכו להיכנס לחשבון.
  2. לוחצים על Service accounts.
  3. מעתיקים את מספר מזהה השותף מהשורה מזהה המפיץ שלך.

שלב 5: הרצת הדוגמה

מריצים את הסקריפט שבקובץ בעזרת העזרה של מערכת ההפעלה. ב-UNIX וב-Mac מריצים את הפקודה הבאה בטרמינל:

python quickstart.py

הדפסת תשובות מה-API

כדי שיהיה קל יותר לבדוק את התשובות כשמנסים את ה-API, צריך לעצב את קובץ ה-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)

פתרון בעיות

אפשר לספר לנו מה השתבש במדריך למתחילים, ונשתדל לתקן את הבעיה. כדי לקבל מידע על האופן שבו חשבונות שירות ללא מגע משמשים לאישור קריאות ל-API, אפשר לעיין ב- הרשאה.

מידע נוסף