Method: devices.create

ব্যবহারকারীর Google Photos অ্যাকাউন্টে একটি পরিবেষ্টিত ডিভাইস তৈরি করে।

যদি প্রদত্ত requestId সহ একটি ডিভাইস ইতিমধ্যেই বিদ্যমান থাকে, একটি ALREADY_EXISTS ত্রুটি ফেরত দেওয়া হয়৷ ডুপ্লিকেট ডিভাইস প্রতিরোধে সাহায্য করতে, নিম্নলিখিতগুলি করুন:

  • আপনি যদি বিদ্যমান ডিভাইসের deviceId জানেন তবে এটি পুনরুদ্ধার করতে devices.get এ কল করুন।
  • আপনি deviceId না জানলে, এই পদ্ধতিটি পুনরায় চেষ্টা করার আগে অনাথ ডিভাইসটি সরাতে requestId সহ devices.delete কল করুন।

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

HTTP অনুরোধ

POST https://photosambient.googleapis.com/v1/devices

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

ক্যোয়ারী প্যারামিটার

পরামিতি
requestId

string

ঐচ্ছিক। এই অনুরোধের জন্য একটি ক্লায়েন্ট-প্রদত্ত অনন্য শনাক্তকারী। এটি একটি নেটওয়ার্ক ব্যর্থতার ক্ষেত্রে রিসোর্স ডুপ্লিকেশন প্রশমিত করতে ব্যবহৃত হয়।

এই আইডিতে অবশ্যই একটি UUID (সংস্করণ 4) স্ট্রিংয়ের ফর্ম্যাট থাকতে হবে এবং এই প্রয়োজনীয়তাগুলি অনুসরণ করুন:

  • ব্যবহারকারী সম্পর্কে কোনো সংবেদনশীল সনাক্তকারী তথ্য থাকা উচিত নয়।
  • "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" (বা 8-4-4-4-12) বিন্যাসে 32টি হেক্সাডেসিমেল অক্ষর থাকতে হবে যা হাইফেন দ্বারা পৃথক পাঁচটি গ্রুপে বিভক্ত।

শরীরের অনুরোধ

অনুরোধের মূল অংশে AmbientDevice একটি উদাহরণ রয়েছে।

প্রতিক্রিয়া শরীর

সফল হলে, রেসপন্স বডিতে AmbientDevice এর একটি নতুন তৈরি উদাহরণ থাকে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/photosambient.mediaitems