रीसेलर के लिए Python क्विकस्टार्ट

इस क्विकस्टार्ट गाइड में दिए गए निर्देशों का पालन करें. करीब 10 मिनट में आपको एक आसान Python कमांड-लाइन ऐप्लिकेशन मिल जाएगा. यह ज़ीरो-टच रजिस्ट्रेशन वाले रीसेलर एपीआई को अनुरोध भेजता है.

ज़रूरी शर्तें

यह क्विकस्टार्ट चलाने के लिए, आपको इन चीज़ों की ज़रूरत होगी:

  • ऐसा Google खाता जो आपके ज़ीरो-टच नामांकन के लिए बनाए गए रीसेलर खाते का सदस्य हो. अगर आपने अब तक इस सुविधा के लिए ऑप्ट-इन नहीं किया है, तो रीसेलर पोर्टल की गाइड में शुरू करें सेक्शन में दिया गया तरीका अपनाएं.
  • Python 2.6 या इसके बाद का वर्शन.
  • pip पैकेज मैनेजमेंट टूल.
  • इंटरनेट और वेब ब्राउज़र का ऐक्सेस.

पहला चरण: ज़ीरो-टच रजिस्ट्रेशन एपीआई को चालू करना

  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. अपने 'पहले से तैयार डिवाइस' सुविधा वाले खाते के साथ सेवा खाते का इस्तेमाल करने के लिए, सेवा खाता लिंक करें पर क्लिक करें.

तीसरा चरण: Google क्लाइंट लाइब्रेरी इंस्टॉल करना

pip का इस्तेमाल करके लाइब्रेरी इंस्टॉल करने के लिए, यह कमांड चलाएं:

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

इंस्टॉल करने के अलग-अलग विकल्पों के लिए, लाइब्रेरी का इंस्टॉलेशन पेज देखें.

चौथा चरण: सैंपल सेट अप करना

अपनी वर्किंग डायरेक्ट्री में 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. आपका रीसेलर आईडी लाइन से अपना पार्टनर आईडी नंबर कॉपी करें.

चरण 5: सैंपल चलाएं

फ़ाइल में स्क्रिप्ट चलाने के लिए, अपने ऑपरेटिंग सिस्टम की मदद लें. UNIX और Mac कंप्यूटर पर, अपने टर्मिनल में नीचे दिए गए निर्देश को चलाएं:

python quickstart.py

एपीआई के रिस्पॉन्स प्रिंट करना

एपीआई को आज़माते समय, जवाबों की जांच करना आसान बनाने के लिए, JSON रिस्पॉन्स डेटा को फ़ॉर्मैट करें. नीचे दिए गए स्निपेट में, JSON मॉड्यूल का इस्तेमाल करके, Python में ऐसा करने का तरीका बताया गया है:

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)

समस्या का हल

क्विकस्टार्ट में हमें बताएं कि क्या समस्या हुई. हम इसे ठीक करने के लिए काम करेंगे. 'पहले से तैयार डिवाइस' सुविधा, एपीआई कॉल को अनुमति देने के लिए सेवा खातों का इस्तेमाल कैसे करती है, यह जानने के लिए अनुमति देना पढ़ें.

ज़्यादा जानें