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

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

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

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

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

पहला चरण: पहले से तैयार डिवाइस को चालू करने वाला एपीआई

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

पांचवां चरण: सैंपल चलाना

फ़ाइल में स्क्रिप्ट चलाने के लिए, अपने ऑपरेटिंग सिस्टम के सहायता कोड का इस्तेमाल करें. 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)

समस्या हल करना

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

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