এই কুইকস্টার্ট গাইডের ধাপগুলি অনুসরণ করুন এবং প্রায় ১০ মিনিটের মধ্যে আপনার কাছে একটি সাধারণ Python কমান্ড-লাইন অ্যাপ থাকবে যা জিরো-টাচ এনরোলমেন্ট রিসেলার API-তে অনুরোধ করে।
পূর্বশর্ত
এই কুইকস্টার্ট রান করতে, আপনার এগুলি প্রয়োজন:
- একটি Google অ্যাকাউন্ট, যা আপনার জিরো-টাচ এনরোলমেন্ট রিসেলার অ্যাকাউন্টের সদস্য। আপনি এখনও অনবোর্ড না করে থাকলে, রিসেলার পোর্টাল গাইড-এ শুরু করুন বিকল্পে গিয়ে ধাপগুলি অনুসরণ করুন।
- Python 2.6 বা তার পরবর্তী ভার্সন।
- pip প্যাকেজ ম্যানেজমেন্ট টুল।
- ইন্টারনেট ও ওয়েব ব্রাউজারে অ্যাক্সেস।
ধাপ ১: জিরো-টাচ এনরোলমেন্ট API চালু করা
- Google Developers Console-এ প্রোজেক্ট তৈরি বা বেছে নিতে এবং অটোমেটিক API চালু করতে এই উইজার্ড ব্যবহার করুন। চালিয়ে যান, তারপর ক্রেডেনশিয়ালে যান বিকল্পে ক্লিক করুন।
- আপনি কোন ডেটা অ্যাক্সেস করবেন? বিকল্পটি অ্যাপ্লিকেশন ডেটা হিসেবে সেট করুন।
- পরবর্তী বিকল্পে ক্লিক করুন। আপনাকে একটি পরিষেবা অ্যাকাউন্ট তৈরি করার জন্য প্রম্পট করা হবে।
- পরিষেবা অ্যাকাউন্টের নাম-এর জন্য একটি বর্ণনামূলক নাম দিন।
- পরিষেবা অ্যাকাউন্ট আইডি (এটি দেখতে ইমেল আইডির মতো) নোট করে রাখুন, কারণ এটি আপনাকে পরে ব্যবহার করতে হবে।
- ভূমিকা পরিষেবা অ্যাকাউন্ট > পরিষেবা অ্যাকাউন্ট ব্যবহারকারী হিসেবে সেট করুন।
- পরিষেবা অ্যাকাউন্ট তৈরি করা সম্পূর্ণ করতে হয়ে গেছে বিকল্পে ক্লিক করুন।
- আপনার তৈরি করা পরিষেবা অ্যাকাউন্টের ইমেল আইডিতে ক্লিক করুন।
- **কী** বিকল্পে ক্লিক করুন।
- **কী যোগ করুন** বিকল্পে ক্লিক করুন, তারপর **নতুন কী তৈরি করুন** বিকল্পে ক্লিক করুন।
- **কী-এর ধরন**-এর জন্য, **JSON** বেছে নিন।
- তৈরি করুন বিকল্পে ক্লিক করুন এবং আপনার কম্পিউটারে ব্যক্তিগত কী ডাউনলোড হয়ে যাবে।
- **বন্ধ করুন** বিকল্পে ক্লিক করুন।
- ফাইলটি আপনার ওয়ার্কিং ডিরেক্টরিতে সরান এবং এটির নাম পরিবর্তন করে
service_account_key.jsonকরুন।
ধাপ ২: পরিষেবা অ্যাকাউন্ট লিঙ্ক করা
- জিরো-টাচ এনরোলমেন্ট পোর্টাল খুলুন। আপনাকে হয়ত সাইন-ইন করতে হবে।
- পরিষেবা অ্যাকাউন্ট বিকল্পে ক্লিক করুন।
- পরিষেবার অ্যাকাউন্ট লিঙ্ক করুন বিকল্পে ক্লিক করুন।
- আপনার তৈরি করা পরিষেবা অ্যাকাউন্টের আইডিতে ইমেল আইডি সেট করুন।
- আপনার জিরো-টাচ এনরোলমেন্ট অ্যাকাউন্টের সাথে পরিষেবা অ্যাকাউন্ট ব্যবহার করতে পরিষেবা অ্যাকাউন্ট লিঙ্ক করুন বিকল্পে ক্লিক করুন।
ধাপ ৩: 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 enrollment 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 কলের জন্য সাধারণত আপনার রিসেলার পার্টনার আইডি আর্গুমেন্ট হিসেবে প্রয়োজন হয়। জিরো-টাচ এনরোলমেন্ট পোর্টাল থেকে আপনার পার্টনার আইডি খুঁজে পেতে, নিচের ধাপগুলি অনুসরণ করুন:
- পোর্টাল খুলুন। আপনাকে হয়ত সাইন-ইন করতে হবে।
- পরিষেবা অ্যাকাউন্ট বিকল্পে ক্লিক করুন।
- আপনার রিসেলার আইডি লাইন থেকে আপনার পার্টনার আইডি নম্বর কপি করুন।
ধাপ ৫: স্যাম্পেল রান করা
ফাইলে স্ক্রিপ্ট রান করতে আপনার অপারেটিং সিস্টেমের সহায়তা নিন। UNIX ও Mac কম্পিউটারে, আপনার টার্মিনালে নিচে উল্লেখ করা কমান্ড রান করুন:
python quickstart.py
API রেসপন্স প্রিন্ট করা হচ্ছে
API ব্যবহার করে দেখার সময় উত্তরগুলি আরও সহজে পরীক্ষা করার জন্য 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)
সমস্যার সমাধান
কুইকস্টার্টের সাথে কী সমস্যা হয়েছে তা আমাদের জানান এবং আমরা তা সমাধান করার চেষ্টা করব। API কল অনুমোদন করতে জিরো-টাচ কীভাবে পরিষেবা অ্যাকাউন্ট ব্যবহার করে তা জানতে, অনুমোদন পড়ুন।