ডিভাইস তৈরি ও ম্যানেজ করা

এই নির্দেশিকায় কীভাবে ডিভাইস তৈরি, ম্যানেজ ও মুছে দিতে হয় তা বলা আছে। সঠিক ডিভাইস ম্যানেজমেন্টের মাধ্যমে ব্যবহারকারীর অভিজ্ঞতা মসৃণ করা এবং Ambient API-এর দক্ষ ব্যবহার করা যায়।

ডিভাইস তৈরি করা

টিভির জন্য OAuth 2.0 এবং সীমিত-ইনপুট ডিভাইস অ্যাপ্লিকেশন ফ্লো ব্যবহার করে কোনও ব্যবহারকারী সফলভাবে যাচাইকরণ করার পরে, তার Google Photos অ্যাকাউন্টে একটি ডিভাইস তৈরি করুন।

আপনার অ্যাপ devices.create পদ্ধতি ব্যবহার করে কোনও ডিভাইস তৈরি করলে, Ambient API একটি AmbientDevice অবজেক্ট রিটার্ন করে যার মধ্যে Google-এর তৈরি করা id অন্তর্ভুক্ত থাকে। এই id নিরাপদে স্টোর করুন এবং আপনার ব্যবহারকারীদের সাথে এটি অ্যাসোসিয়েট করুন।

গুরুত্বপূর্ণ: id সেভ করুন। Google-এর তৈরি করা id আপনি সেভ না করলে, পরে কোনও ডিভাইস ফিরিয়ে আনতে বা ম্যানেজ করতে পারবেন না। এর ফলে আপনার ব্যবহারকারীর Google Photos অ্যাকাউন্টে অনাথ ডিভাইস তৈরি হতে পারে, যা আপনার অ্যাপ্লিকেশন অ্যাক্সেস বা ক্লিন-আপ করতে পারবে না।

OAuth-এর মাধ্যমে স্ট্রিমলাইনড ডিভাইস তৈরি করা

Ambient API একটি স্ট্রিমলাইন করা OAuth ফ্লো অফার করে। আপনার প্রাথমিক OAuth অনুরোধে অতিরিক্ত state প্যারামিটার পাস করে এবং ম্যাচিং requestId-এর সাথে devices.create কল করে, আপনি সরাসরি ব্যবহারকারীর সাইন-ইন ফ্লোতে ডিভাইস তৈরি করার প্রসেস লিঙ্ক করতে পারবেন, যার ফলে ব্যবহারকারীকে কম QR কোড স্ক্যান করতে হবে এবং তার অভিজ্ঞতা আরও সহজ হবে।

আরও বিবরণ ও উদাহরণের জন্য, Ambient API-এর জন্য স্ট্রীমলাইনড যাচাইকরণ ফ্লো গাইড দেখুন।

ডিভাইসের সীমা

আপনার অ্যাপ্লিকেশন প্রতি ব্যবহারকারীর জন্য সর্বাধিক ১০০টি ডিভাইস তৈরি করতে পারে। এই সীমা পেরিয়ে গেলে, API একটি RESOURCE_EXHAUSTED সমস্যা দেখায়।

ডিভাইস ম্যানেজ করা

কোনও ডিভাইস তৈরি করে ব্যবহারকারীর Google Photos অ্যাকাউন্টের সাথে লিঙ্ক করার পরে, আপনাকে সেটির লাইফসাইকেল ম্যানেজ করতে হতে পারে।

ডিভাইস ফিরিয়ে আনা

নির্দিষ্ট কোনও ডিভাইস সম্পর্কে তথ্য পেতে, অনন্য id সহ devices.get পদ্ধতি ব্যবহার করুন। এটি ডিভাইসের স্ট্যাটাস চেক করার জন্য উপযোগী, যেমন mediaSourcesSet সত্য কিনা।

ডিভাইস আপডেট করা

আপনি devices.patch পদ্ধতি ব্যবহার করে আগে থেকে থাকা ডিভাইসের নির্দিষ্ট কিছু প্রপার্টি আপডেট করতে পারবেন, যেমন, এটির ডিসপ্লে নাম। এটি ব্যবহারকারীদের তাদের ডিভাইস পছন্দমতো করে নিতে এবং Google Photos-এ সেগুলি সহজে শনাক্ত করতে সাহায্য করে।

মনে রাখবেন: ডিভাইস তৈরি করার আগে ব্যবহারকারীকে সেটির নাম দেওয়ার সুযোগ দেওয়া একটি ভাল প্র্যাক্টিস। এর ফলে, ব্যবহারকারী তার Google Photos অ্যাকাউন্ট থেকে মিডিয়া আইটেম বেছে নেওয়ার সময় নিজের ডিভাইস আরও সহজে শনাক্ত করতে পারেন।

ডিভাইসগুলি মুছুন

সঠিকভাবে ক্লিন-আপ ও ব্যবহারকারীর নিয়ন্ত্রণের জন্য ডিভাইস মুছে ফেলার স্ট্র্যাটেজি প্রয়োগ করুন। আপনি devices.delete পদ্ধতি ব্যবহার করে কোনও ডিভাইস মুছে দিতে পারবেন।

ডিভাইস মুছে দেওয়ার জন্য নিম্নলিখিত পরিস্থিতিগুলি বিবেচনা করুন:

• ব্যবহারকারী ডিসকানেক্ট করলে: কোনও ব্যবহারকারী তার Google Photos অ্যাকাউন্ট থেকে আপনার অ্যাপ্লিকেশন ডিসকানেক্ট করলে, আপনাকে সংশ্লিষ্ট ডিভাইসটি মুছে দিতে হবে।
• অনাথ ডিভাইস: আপনি যদি id-এর ট্র্যাক হারিয়ে ফেলেন, কিন্তু এখনও requestId থাকে যা তৈরি করার সময় ব্যবহার করা হয়েছিল, তাহলে আপনি requestId-এর সাথে devices.delete ব্যবহার করে অনাথ ডিভাইস সরিয়ে দিতে পারবেন। এটি অনিচ্ছাকৃতভাবে ডুপ্লিকেট হওয়া আটকায় এবং ব্যবহারকারীর অ্যাকাউন্ট পরিষ্কার রাখে।

গুরুত্বপূর্ণ বিবেচনা ও পেশাদার পদ্ধতি

• ডিভাইসের লাইফসাইকেল ও ব্যবহারকারীর অনুমোদন: আপনাকে ডিভাইসের লাইফসাইকেল ও ব্যবহারকারীর অনুমোদন টোকেন ম্যানেজ করতে হবে। ডিভাইস কতক্ষণ অ্যাক্টিভ থাকে এবং কোনও ডিভাইস ইনঅ্যাক্টিভ হয়ে গেলে বা টোকেনের মেয়াদ শেষ হয়ে গেলে আপনি কীভাবে টোকেন রিফ্রেশ বা আবার অনুমোদন করবেন তা বিবেচনা করুন।
• সমস্যার সমাধান: ডিভাইস সম্পর্কিত সব API কলের জন্য সমস্যার সমাধান করার শক্তিশালী ব্যবস্থা প্রয়োগ করুন। এই ধরনের পরিস্থিতির জন্য প্রস্তুত থাকুন:
  • NOT_FOUND: ডিভাইস না থাকলে বা ব্যবহারকারী সেটির মালিক না হলে।
  • RESOURCE_EXHAUSTED: আপনি ডিভাইসের সীমা অতিক্রম করলে।
  • ALREADY_EXISTS: আপনি যদি এমন একটি requestId দিয়ে ডিভাইস তৈরি করার চেষ্টা করেন যা আগে থেকেই আছে।

পরবর্তী ধাপ

• নমুনা অ্যাপ্লিকেশন: আমাদের নমুনা অ্যাপ্লিকেশন ডিভাইস তৈরি করা এবং উত্তর ডেটা নিয়ে কাজ করার একটি উদাহরণ অন্তর্ভুক্ত করে। আরও তথ্যের জন্য createDevice ফাংশন চেক করে দেখুন।
• রেফারেন্স ডকুমেন্টেশন: উপলভ্য সব পদ্ধতি, অনুরোধ ও উত্তর প্যারামিটার এবং এরর কোড সম্পর্কে বিস্তারিত তথ্য পেতে ডিভাইস সংক্রান্ত রেফারেন্স ডকুমেন্ট পুঙ্খানুপুঙ্খভাবে পর্যালোচনা করুন।
• মিডিয়া আইটেম তালিকাভুক্ত ও রিস্টোর করা: আপনার ডিভাইস তৈরি ও ম্যানেজ করার পরে, সেগুলিতে দেখানোর জন্য কীভাবে মিডিয়া আইটেম তালিকাভুক্ত ও রিস্টোর করবেন তা জানুন।