Developers এর পক্ষ থেকে Google Nest ডিভাইসগুলি দেখতে এবং পরিচালনা করতে SDM API ব্যবহার করতে পারে৷ users SDM API যাচাই করে যে user অ্যাক্সেস করা ডিভাইস পরিচালনা করে, যে user সম্মতি দিয়েছেনdeveloper পড়া বা লেখা প্রতিটি ডিভাইসের বৈশিষ্ট্য, এবং যেdeveloper প্রতিটি বৈশিষ্ট্য অ্যাক্সেসের জন্য সাদা তালিকাভুক্ত করা হয়েছে.
ডিভাইস পরিচালনার জন্য SDM API ব্যবহার করতে,developer প্রথম দ্বারা অনুমোদিত হতে হবে user.
অনুমোদন প্রক্রিয়ার একটি ওয়াকথ্রু জন্য, একটি অ্যাকাউন্ট অনুমোদন পৃষ্ঠা দেখুন Device Access দ্রুত শুরু নির্দেশিকা.
অনুমোদন ত্রুটির সমস্যা সমাধানে সহায়তার জন্য, অনুমোদন ত্রুটি দেখুন।
OAuth প্রবাহ
SDM API এর জন্য একটি তিন-পাওয়ালা Google OAuth প্রবাহ ব্যবহার করেuser অনুমোদন:
- কখন a user অনুমোদন করতে চায় a developer নেস্ট ডিভাইস পরিচালনার জন্য, developer পাঠায়user PCM থেকে, যেখানে userতাদের Google অ্যাকাউন্টে লগ ইন করে।
- দ user জন্য মঞ্জুর অনুমতি নির্বাচন করে 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 সক্ষম করুন
একটি জন্য PCM ভিউ সক্রিয় করতে user, অনুমোদনের অনুরোধের জন্য এই নতুন OAuth এন্ডপয়েন্ট দিয়ে স্ট্যান্ডার্ড Google API OAuth 2.0 এন্ডপয়েন্ট প্রতিস্থাপন করুন:
https://nestservices.google.com/partnerconnections/project-id/auth
URL-এ এই প্যারামিটারগুলি ব্যবহার করুন:
প্যারামিটার | বর্ণনা |
---|---|
redirect_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-এর সমস্ত কলগুলিকে প্রদত্ত অনন্য অ্যাক্সেস টোকেন ব্যবহার করতে হবে developer দ্বারাuser অনুমোদনের সময়। অ্যাক্সেস টোকেনগুলি স্বল্পস্থায়ী এবং অবিরত অ্যাক্সেস নিশ্চিত করতে নিয়মিত রিফ্রেশ করতে হবে।
যদি a user পরে প্রত্যাহার করে developer একটি কাঠামো বা একটি ডিভাইস অ্যাক্সেস, অ্যাক্সেস টোকেন অবিলম্বে মেয়াদ শেষ হয়ে যায় এবং রিফ্রেশ করা যাবে না, এবংdeveloper এর পক্ষে আর SDM API কল করতে পারবে না user.
অ্যাকাউন্ট অনুমোদন প্রত্যাহার করুন
একটি Google অ্যাকাউন্টের অনুমোদন বাতিল করার একাধিক উপায় রয়েছে৷ ব্যবহারকারীর জন্য পছন্দের পদ্ধতি হল অ্যাকাউন্টের অনুমতিগুলি সংশোধন করতে অংশীদার সংযোগ ব্যবস্থাপক (PCM) ব্যবহার করা৷ আরও তথ্যের জন্য অ্যাকাউন্ট অনুমতি পরিবর্তন দেখুন. একটি অ্যাক্সেস টোকেন নিম্নলিখিত পদ্ধতি দ্বারা প্রত্যাহার করা যেতে পারে:
ব্যবহারকারী https://myaccount.google.com/permissions এ প্রত্যাহার করতে পারেন।
বিকাশকারী এন্ডপয়েন্ট
https://oauth2.googleapis.com/revoke
এ অ্যাক্সেস টোকেন পাস করতে পারেন। Google OAuth এবং টোকেন প্রত্যাহার সম্পর্কে আরও জানতে, একটি টোকেন প্রত্যাহার করা দেখুন।
এমবেডেড ওয়েবভিউ
একটি নতুন সুরক্ষিত ব্রাউজার নীতি এম্বেড করা ব্রাউজার লাইব্রেরিতে Google OAuth অনুরোধগুলিকে সাধারণত এম্বেড করা ওয়েবভিউ হিসাবে উল্লেখ করা নিষিদ্ধ করে৷ সমস্ত এমবেডেড ওয়েবভিউ ব্লক করা হবে। এমবেডেড ওয়েবভিউ লাইব্রেরিগুলি সমস্যাযুক্ত কারণ তারা একটি খারাপ বিকাশকারীকে Google এবং এর ব্যবহারকারীদের মধ্যে যোগাযোগগুলিকে বাধা দিতে এবং পরিবর্তন করতে দেয়৷ এমবেডেড ওয়েবভিউ শুধুমাত্র অ্যাকাউন্ট নিরাপত্তাকে প্রভাবিত করে না, তারা আপনার অ্যাপ্লিকেশনের ব্যবহারযোগ্যতাকে প্রভাবিত করতে পারে।
আপনি যদি এই নীতি দ্বারা প্রভাবিত হন, তাহলে এম্বেড করা ওয়েবভিউ সমর্থন নিবন্ধে Google-এর OAuth 2.0 অনুমোদনের শেষ পয়েন্টে আসন্ন নিরাপত্তা পরিবর্তনগুলি উল্লেখ করুন৷