ডিভাইস তৈরি এবং পরিচালনা করুন

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

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

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

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

OAuth এর সাথে স্ট্রীমলাইনড ডিভাইস তৈরি

অ্যাম্বিয়েন্ট এপিআই একটি সুগমিত OAuth প্রবাহ অফার করে যা ব্যবহারকারীর প্রমাণীকরণের সাথে একযোগে একটি ডিভাইস তৈরি করতে পারে। আপনার প্রাথমিক OAuth অনুরোধে অতিরিক্ত state প্যারামিটার পাস করে, আপনি ডিভাইস তৈরির প্রক্রিয়াটিকে ব্যবহারকারীর সাইন-ইন প্রবাহের সাথে সরাসরি লিঙ্ক করতে পারেন, তাদের স্ক্যান করার জন্য প্রয়োজনীয় QR কোডের সংখ্যা কমিয়ে ব্যবহারকারীর অভিজ্ঞতা সহজতর করে৷

আরো বিস্তারিত এবং একটি উদাহরণের জন্য, পরিবেষ্টিত API গাইডের জন্য স্ট্রীমলাইনড প্রমাণীকরণ প্রবাহ দেখুন।

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

আপনার অ্যাপ্লিকেশন প্রতি ব্যবহারকারী 100টি পর্যন্ত ডিভাইস তৈরি করতে পারে৷ এই সীমা অতিক্রম করলে, API একটি RESOURCE_EXHAUSTED ত্রুটি প্রদান করে।

ডিভাইস পরিচালনা করুন

একবার একটি ডিভাইস তৈরি হয়ে গেলে এবং ব্যবহারকারীর Google Photos অ্যাকাউন্টের সাথে লিঙ্ক করা হলে, আপনাকে এর জীবনচক্র পরিচালনা করতে হতে পারে।

ডিভাইস পুনরুদ্ধার করুন

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

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

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

ডিভাইস মুছুন

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

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

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

গুরুত্বপূর্ণ বিবেচনা এবং সর্বোত্তম অভ্যাস

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

পরবর্তী পদক্ষেপ