Developers SDM API ব্যবহার করে users-এর হয়ে Google Nest ডিভাইসগুলি দেখতে ও পরিচালনা করতে পারে। SDM API যাচাই করে যে user অ্যাক্সেস করা ডিভাইসগুলি পরিচালনা করে, যে user developer প্রতিটি ডিভাইসের বৈশিষ্ট্যগুলি পড়তে বা লিখতে সম্মতি দিয়েছে এবংdeveloper প্রতিটি অ্যাক্সেসের জন্য সাদা তালিকাভুক্ত করা হয়েছে৷
ডিভাইস পরিচালনার জন্য SDM API ব্যবহার করতে,developer প্রথমে userদ্বারা অনুমোদিত হতে হবে।
অনুমোদন প্রক্রিয়ার একটি ওয়াকথ্রু জন্য, Device Access কুইক স্টার্ট গাইডের একটি অ্যাকাউন্ট অনুমোদন পৃষ্ঠাটি দেখুন।
অনুমোদন ত্রুটির সমস্যা সমাধানে সহায়তার জন্য, অনুমোদন ত্রুটি দেখুন।
OAuth প্রবাহ
SDM APIuser অনুমোদনের জন্য একটি তিন পায়ের Google OAuth ফ্লো ব্যবহার করে:
- a user যখন Nest ডিভাইসগুলির পরিচালনার জন্য a developer অনুমোদন করতে চায়, developer user PCM-এ পাঠায়, যেখানে userতাদের Google অ্যাকাউন্টে লগ ইন করে।
- user PCM-এ developerএর জন্য অনুমতি দেওয়ার অনুমতি বেছে নেয়।
- user OAuth-এর মাধ্যমে সম্মতি প্রদান করে,developer একটি অনুমোদন কোড প্রদান করে।
- developer একটি অ্যাক্সেস টোকেন পুনরুদ্ধার করতে অনুমোদন কোড ব্যবহার করে।
- developer ডিভাইস পরিচালনার জন্য SDM API-তে কল করার সাথে অ্যাক্সেস টোকেন ব্যবহার করে।
Google OAuth এবং কীভাবে সেট আপ করবেন সে সম্পর্কে আরও জানতে, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করা দেখুন।
পার্টনার কানেকশন ম্যানেজার (PCM)
PCM SDM API দ্বারা সরবরাহ করা হয়। এটি এমন একটি দৃশ্য যাuser developerকে মঞ্জুর করতে পারে এমন সমস্ত কাঠামো, ডিভাইস এবং অ্যাক্সেস বিকল্পগুলির তালিকা করে। userঅনুমোদন প্রক্রিয়া চলাকালীন কী অ্যাক্সেস দিতে হবে তা বেছে নেয় এবং সেই অ্যাক্সেসের নিয়ন্ত্রণ বজায় রাখে।
PCM মানচিত্রে বৈশিষ্ট্য গোষ্ঠীর জন্য নির্বাচিত বিকল্পগুলি, যা বৈশিষ্ট্যের সংগ্রহ developer এর অ্যাক্সেস দেওয়া হবে।developer কি ধরনের ইন্টিগ্রেশন userকে অফার করছে তার উপর নির্ভর করে কিছু বৈশিষ্ট্য গোষ্ঠী একত্রে সংযুক্ত থাকে এবং সেই ইন্টিগ্রেশন সক্ষম করতে userঅবশ্যই সেই লিঙ্কযুক্ত বৈশিষ্ট্য গোষ্ঠীগুলির জন্য অনুমতি দিতে হবে। অন্যথায়, ব্যবহারকারীর ইচ্ছা অনুযায়ী ব্যক্তিগত, লিঙ্কমুক্ত বৈশিষ্ট্য গোষ্ঠীর জন্য অনুমতি দেওয়ার ক্ষমতা রয়েছে।
PCM সক্ষম করুন
userএর জন্য PCM ভিউ সক্ষম করতে, অনুমোদনের অনুরোধের জন্য এই নতুন OAuth এন্ডপয়েন্ট দিয়ে স্ট্যান্ডার্ড Google API OAuth 2.0 এন্ডপয়েন্ট প্রতিস্থাপন করুন:
https://nestservices.google.com/partnerconnections/project-id/auth
URL-এ এই প্যারামিটারগুলি ব্যবহার করুন:
প্যারামিটার | বর্ণনা |
---|---|
redirect_uri | URI সফল অনুমোদনের পরে user নির্দেশ করে। |
client_id | আপনার Google ক্লাউড প্রকল্প থেকে OAuth 2.0 ক্লায়েন্ট আইডি। নিশ্চিত করুন যে এটি আপনার Project আইডির সাথে সম্পর্কিত একই। মনে রাখবেন যে একটি OAuth ক্লায়েন্ট আইডি অবশ্যই বৈধ এবং একটি projectএর জন্য অনন্য হতে হবে এবং অন্য projects এর সাথে শেয়ার করা যাবে না৷ |
access_type | ব্যবহার করার মান: offline |
prompt | ব্যবহার করার মান: consent |
response_type | ব্যবহার করার মান: code বিনিময়ে একটি অনুমোদন কোড প্রত্যাশিত৷ |
scope | ব্যবহার করার মান: https://www.googleapis.com/auth/sdm.service SDM API সুযোগ। |
state | ঐচ্ছিক। অনুরোধ এবং কলব্যাকের মধ্যে অবস্থা বজায় রাখতে developer ক্লায়েন্ট দ্বারা ব্যবহৃত একটি অস্বচ্ছ মান। |
উদাহরণ PCM URL:
https://nestservices.google.com/partnerconnections/
2f6989ca-c756-4625-8cdc-d5b1edfb2dcd/auth?
redirect_uri=https://www.example.com/api/link/M258KP8OWYZDVQ&
client_id=418235700063-sdkiav89orn5r1nvrcr5t210qqjimq8l.apps.googleusercontent.com&
access_type=offline&
prompt=consent&
response_type=code&
scope=https://www.googleapis.com/auth/sdm.service
user অনুমতি দেওয়ার পরে, রিডাইরেক্ট URI-তে code
প্যারামিটার হিসাবে একটি অনুমোদন কোড ফেরত দেওয়া হয়। একটি অ্যাক্সেস টোকেন পেতে এই কোড ব্যবহার করুন.
আপনার অ্যাপে PCM যোগ করুন
আপনার অ্যাপে, এই URL ব্যবহার করে PCM ভিউ যোগ করুন:
https://nestservices.google.com/partnerconnections
যখন user লগ ইন করা হয়, এই পৃষ্ঠাটি তাদের সমস্ত লিঙ্ক করাDevice Access developers দেখায়, সেইসাথে অনুমতি প্রদান এবং প্রত্যাহার করার জন্য টগল সহ সমস্ত কাঠামো এবং ডিভাইসের একটি তালিকা দেখায়৷ user এই পৃষ্ঠা থেকে প্রতি-অংশীদার ভিত্তিতে একটি অংশীদার সংযোগ বিচ্ছিন্ন করতে পারে।
যাচাইকৃত অ্যাপস
SDM API একটি সীমাবদ্ধ স্কোপ ব্যবহার করে, যার মানে হল যে কোনও অ্যাপ যেগুলি অনুমোদনের সময় এই সুযোগ ব্যবহার করে সেগুলি "অযাচাই করা" হবে যদি না OAuth API যাচাইকরণ সম্পূর্ণ হয়। ব্যক্তিগত ব্যবহারের জন্য Device Access ব্যবহার করার সময়, OAuth API যাচাইকরণের প্রয়োজন নেই।
অনুমোদন প্রক্রিয়া চলাকালীন আপনি একটি "Google এই অ্যাপটি যাচাই করেনি" স্ক্রীন দেখতে পেতে পারেন, যা Google ক্লাউডে আপনার OAuth সম্মতি স্ক্রীনে sdm.service
স্কোপ কনফিগার না করা থাকলে দেখা যায়। অ্যাডভান্সড বিকল্পে ক্লিক করে এবং তারপরে প্রকল্পের নামে যান (অনিরাপদ) ক্লিক করে এই স্ক্রীনটি বাইপাস করা যেতে পারে।
আরও তথ্যের জন্য যাচাইকৃত অ্যাপ স্ক্রীন দেখুন।
টোকেন অ্যাক্সেস করুন
অনুমোদিত কাঠামো এবং ডিভাইসগুলি পরিচালনা করার জন্য SDM API-এর সমস্ত কলগুলিকে অনুমোদনের সময়user দ্বারা developer placeholder269-এ দেওয়া অনন্য অ্যাক্সেস টোকেন ব্যবহার করতে হবে। অ্যাক্সেস টোকেনগুলি স্বল্পস্থায়ী এবং অবিরত অ্যাক্সেস নিশ্চিত করতে নিয়মিত রিফ্রেশ করতে হবে।
যদি a user পরে কোনও কাঠামো বা কোনও ডিভাইসে developer অ্যাক্সেস প্রত্যাহার করে, অ্যাক্সেস টোকেন অবিলম্বে মেয়াদ শেষ হয়ে যায় এবং রিফ্রেশ করা যাবে না এবংdeveloper আর সেই userএর পক্ষে SDM API-কে কল করতে পারবে না।
অ্যাকাউন্ট অনুমোদন প্রত্যাহার করুন
একটি Google অ্যাকাউন্টের অনুমোদন বাতিল করার একাধিক উপায় রয়েছে৷ ব্যবহারকারীর জন্য পছন্দের পদ্ধতি হল অ্যাকাউন্টের অনুমতিগুলি সংশোধন করতে অংশীদার সংযোগ ব্যবস্থাপক (PCM) ব্যবহার করা৷ আরও তথ্যের জন্য অ্যাকাউন্ট অনুমতি পরিবর্তন দেখুন. একটি অ্যাক্সেস টোকেন নিম্নলিখিত পদ্ধতি দ্বারা প্রত্যাহার করা যেতে পারে:
ব্যবহারকারী https://myaccount.google.com/permissions এ প্রত্যাহার করতে পারেন।
বিকাশকারী এন্ডপয়েন্ট
https://oauth2.googleapis.com/revoke
এ অ্যাক্সেস টোকেন পাস করতে পারেন। Google OAuth এবং টোকেন প্রত্যাহার সম্পর্কে আরও জানতে, একটি টোকেন প্রত্যাহার করা দেখুন।
এমবেডেড ওয়েবভিউ
একটি নতুন সুরক্ষিত ব্রাউজার নীতি এম্বেড করা ব্রাউজার লাইব্রেরিতে Google OAuth অনুরোধগুলিকে সাধারণত এম্বেড করা ওয়েবভিউ হিসাবে উল্লেখ করা নিষিদ্ধ করে৷ সমস্ত এমবেডেড ওয়েবভিউ ব্লক করা হবে। এমবেডেড ওয়েবভিউ লাইব্রেরিগুলি সমস্যাযুক্ত কারণ তারা একটি খারাপ বিকাশকারীকে Google এবং এর ব্যবহারকারীদের মধ্যে যোগাযোগগুলিকে বাধা দিতে এবং পরিবর্তন করতে দেয়৷ এমবেডেড ওয়েবভিউ শুধুমাত্র অ্যাকাউন্ট নিরাপত্তাকে প্রভাবিত করে না, তারা আপনার অ্যাপ্লিকেশনের ব্যবহারযোগ্যতাকে প্রভাবিত করতে পারে।
আপনি যদি এই নীতি দ্বারা প্রভাবিত হন, তাহলে এম্বেড করা ওয়েবভিউ সমর্থন নিবন্ধে Google-এর OAuth 2.0 অনুমোদনের শেষ পয়েন্টে আসন্ন নিরাপত্তা পরিবর্তনগুলি উল্লেখ করুন৷