গুগল হেলথ এপিআই হলো একেবারে গোড়া থেকে তৈরি একটি পূর্ণাঙ্গ সমাধান, যা ডেভেলপারদেরকে ব্যবহারকারীর সম্মতিপ্রাপ্ত স্বাস্থ্য সংক্রান্ত বিপুল পরিমাণ ডেটা এবং বিভিন্ন ধরনের ডেটাতে শক্তিশালী অ্যাক্সেস প্রদান করে। গুগল হেলথ এপিআই আপনার অ্যাপ নিবন্ধন করার জন্য একটি নতুন কনসোল, গুগল ওঅথ ২.০ (Google OAuth 2.0), নতুন ডেটা টাইপ, নতুন এন্ডপয়েন্ট স্কিমা এবং একটি নতুন রেসপন্স ফরম্যাট ব্যবহার করে।
এই নির্দেশিকাটি ডেভেলপারদের তাদের বিদ্যমান ফিটবিট ওয়েব এপিআই অ্যাপগুলোকে নতুন গুগল হেলথ এপিআই-তে স্থানান্তরিত করতে সাহায্য করার জন্য তৈরি করা হয়েছে। এতে ব্যবহারকারীদের ধরে রেখে একটি নির্বিঘ্ন স্থানান্তর নিশ্চিত করার জন্য সুপারিশসমূহ অন্তর্ভুক্ত রয়েছে।
আপনার কেন অভিবাসন করা উচিত?
এটি শুধু একটি আপডেট নয়, বরং আপনার অ্যাপগুলোকে সুরক্ষিত রাখা এবং স্বাস্থ্য প্রযুক্তির ভবিষ্যৎ অগ্রগতির জন্য প্রস্তুত রাখার একটি কৌশলগত পদক্ষেপ। গুগল হেলথ এপিআই ব্যবহারের কিছু সুবিধা হলো:
- ব্যাপক ডেটাতে প্রবেশাধিকার : ব্যবহারকারীর সম্মতিক্রমে প্রাপ্ত স্বাস্থ্য সংক্রান্ত বিস্তৃত ডেটা এবং বিভিন্ন ধরণের ডেটাতে নির্ভরযোগ্য প্রবেশাধিকার লাভ করুন।
- উন্নত নিরাপত্তা : গুগলের নিরাপত্তা সংক্রান্ত সর্বোত্তম অনুশীলনসমূহের সাথে সঙ্গতি এবং গুগলের নিরাপত্তা, গোপনীয়তা ও পরিচয় মানদণ্ডের সাথে সামঞ্জস্য।
- সামঞ্জস্য : ডেটা ফরম্যাট, টাইম জোন, পরিমাপের একক এবং ত্রুটি ব্যবস্থাপনার ক্ষেত্রে পুরোনো অসঙ্গতিগুলো দূর করে ডেভেলপারদের জন্য আরও সহজবোধ্য অভিজ্ঞতা নিশ্চিত করে।
- সম্প্রসারণযোগ্যতা ও ভবিষ্যৎ-উপযোগিতা : ভবিষ্যতের চাহিদা মেটাতে সম্প্রসারণের জন্য ডিজাইন করা হয়েছে এবং gRPC-এর মতো আধুনিক প্রোটোকল সমর্থন করে।
Fitbit Web API থেকে Google Health API-তে স্থানান্তরের জন্য শুধু প্রযুক্তিগত পরিবর্তনের চেয়েও বেশি কিছু প্রয়োজন। নতুন OAuth লাইব্রেরিতে স্থানান্তরের কারণে, বিদ্যমান অ্যাক্সেস এবং রিফ্রেশ টোকেনগুলো স্থানান্তর করা যাবে না, ফলে ব্যবহারকারীদের আপনার হালনাগাদ করা ইন্টিগ্রেশনে পুনরায় সম্মতি দিতে হবে।
উভয় লগইন পদ্ধতি সমর্থন করুন
যেহেতু Fitbit Web API এবং Google Health API ব্যবহারকারী লগইন পরিচালনার জন্য ভিন্ন ভিন্ন সিস্টেম ব্যবহার করে, তাই Fitbit Web API সক্রিয় থাকাকালে আপনার অ্যাপটিকে সাময়িকভাবে একই সাথে উভয় পদ্ধতিই সমর্থন করতে হবে।
আপনার অ্যাপ সরাসরি ডেটা চাওয়ার পরিবর্তে, এমন একটি লেয়ার যুক্ত করুন যা কোনো নির্দিষ্ট ব্যবহারকারীর জন্য ফিটবিট ওয়েব এপিআই (Fitbit Web API) নাকি গুগল হেলথ এপিআই (Google Health API) ব্যবহার করবে, সেই সিদ্ধান্ত নেবে। এর ফলে আপনার অ্যাপের বাকি অংশকে এই খুঁটিনাটি বিষয়গুলো নিয়ে চিন্তা করতে হবে না।
ব্যবহারকারীরা কোন লগইন সিস্টেম ব্যবহার করছেন তা শনাক্ত করার জন্য আপনার ব্যবহারকারী ডেটাবেসে একটি ফ্ল্যাগ (যেমন, oauth_type ) অন্তর্ভুক্ত করে তা আপডেট করুন।
- নতুন ব্যবহারকারীদের জন্য : নতুন গুগল হেলথ এপিআই (
oauth_type: google) দিয়ে তাদেরকে স্বয়ংক্রিয়ভাবে সেট আপ করুন। - বিদ্যমান ব্যবহারকারীদের জন্য : তাদের সম্মতি (
oauth_type: fitbit) আপডেট না করা পর্যন্ত Fitbit ওয়েব API-তে রাখুন।
ব্যবহারকারীর অভিজ্ঞতায় ব্যাঘাত এড়াতে, আমরা সবাইকে লগ আউট করে আবার লগ ইন করতে বাধ্য না করার পরামর্শ দিচ্ছি। পরিবর্তে:
- যখন Fitbit Web API-এর সাথে সংযুক্ত কোনো ব্যবহারকারী আপনার অ্যাপ ব্যবহার করেন, তখন তাদের সংযোগ আপডেট করতে উৎসাহিত করে একটি বন্ধুত্বপূর্ণ বিজ্ঞপ্তি দেখান।
- যখন ব্যবহারকারী আপডেট করার কাজটি গ্রহণ করবেন, ঠিক তখনই গুগল হেলথ লগইন প্রক্রিয়াটি চালু করুন।
- গুগল লগইন সফল হলে, ব্যবহারকারীর প্রোফাইলে নতুন গুগল ক্রেডেনশিয়ালগুলো সেভ করুন এবং তাদের
oauth_typeফ্ল্যাগটিfitbitথেকেgoogleএ পরিবর্তন করুন। আপনার সেটআপে অনুমতি থাকলে, সবকিছু পরিপাটি ও সুরক্ষিত রাখতে তাদের টোকেনগুলো বাতিল করে প্রোগ্রাম্যাটিকভাবে পুরোনো ফিটবিট সিস্টেম থেকে সাইন আউট করে দিন।
ডেটার ধারাবাহিকতা নিশ্চিত করুন
পুরোনো Fitbit Web API থেকে Google Health API-তে কোনো ইন্টিগ্রেশন স্থানান্তরের সময়, ডেভেলপার অ্যাপ্লিকেশনগুলোকে ব্যবহারকারী শনাক্তকরণ কাঠামোর পরিবর্তনটি অবশ্যই বিবেচনায় রাখতে হবে।
পুরোনো ফিটবিট ওয়েব এপিআই একটি ৬-অক্ষরের আলফানিউমেরিক স্ট্রিং (যেমন A1B2C3 ) ব্যবহার করে অ্যাকাউন্ট শনাক্ত করে, অন্যদিকে গুগল হেলথ এপিআই সর্বোচ্চ ৬৩টি সংখ্যা ও অক্ষরের একটি স্ট্রিং হিসেবে ফরম্যাট করা healthUserId ব্যবহার করে।
ব্যবহারকারীর প্রেক্ষাপট না হারিয়ে এই ব্যবধান পূরণ করতে, ডেভেলপাররা Fitbit এবং Health ইউজার আইডি পাওয়ার জন্য getIdentity এন্ডপয়েন্টটি কোয়েরি করতে পারেন। এই এন্ডপয়েন্টটি legacyUserId এবং নতুন healthUserId উভয়ই সম্বলিত একটি পেলোড রিটার্ন করে, যা অ্যাপ্লিকেশনগুলিকে বিদ্যমান রেকর্ড এবং নতুন অ্যাকাউন্ট সিস্টেমের মধ্যে গতিশীলভাবে একটি ম্যাপিং তৈরি করতে সক্ষম করে।
ঐতিহাসিক ডেটা পূরণ করুন
যদি কোনো ব্যবহারকারী পুরোনো এন্ডপয়েন্টগুলো বন্ধ করার আগে নতুন গুগল হেলথ এপিআই এন্ডপয়েন্টগুলোতে প্রমাণীকরণ না করেন, তবুও যতক্ষণ তিনি তার ডিভাইসটি গুগল হেলথ অ্যাপের সাথে সিঙ্ক করতে থাকবেন, ততক্ষণ তার ডেটা উপলব্ধ থাকবে। তবে, এই ব্যবহারকারীর ডেটাতে একটি ফাঁক থাকতে পারে।
ব্যবহারকারী নতুন এন্ডপয়েন্টগুলিতে পুনরায় প্রমাণীকরণ করার পর, তাদের ডেটা পুনরায় পূরণ করার জন্য আপনি আমাদের Google Health API ব্যবহার করে তাদের পূর্ববর্তী ডেটা পূরণ করতে পারেন। নির্দেশনার জন্য 'পূর্ববর্তী ডেটা কোয়েরি করুন' দেখুন।
যোগাযোগ এবং সময়
আপনার ব্যবহারকারীদের বিদ্যমান Fitbit OAuth থেকে নতুন Google OAuth-এ স্থানান্তরিত হতে সাহায্য করার জন্য, এই সর্বোত্তম পদ্ধতিগুলো অনুসরণ করুন।
মূল্য-প্রথম যোগাযোগ
"আমরা আমাদের এপিআই আপডেট করেছি" এই কথা দিয়ে শুরু না করে, আপনার অ্যাপে গুগল হেলথ ডেটা ইন্টিগ্রেট করার সুবিধাগুলো দিয়ে শুরু করুন, তবে এটাও নিশ্চিত করুন যে তারা যেন জানে যে তাদের ডেটা সিঙ্ক করতে চাইলে পুনরায় অথেন্টিকেট করতে হবে।
- আপনার অ্যাপে ইন্টিগ্রেশনের মাধ্যমে কী কী ফিচার পাওয়া যায় তা স্পষ্টভাবে ব্যাখ্যা করুন এবং ব্যবহারকারী কীভাবে সেই ফিচারগুলো থেকে উপকৃত হবেন, সেই অনুযায়ী আপনার বার্তাটি সাজিয়ে নিন।
- প্রযুক্তিগত বাস্তবায়নের বিবরণের পরিবর্তে আপনার বৈশিষ্ট্যগুলোর ওপর মনোযোগ দিন এবং ব্যবহারের উদাহরণ দিন।
- বলবেন না : "আপনি ফিটবিট এপিআই-এর সাথে সংযোগ করতে পারবেন না।"
- বলুন : "হার্ট রেট ডেটা সহ বিস্তারিত ওয়ার্কআউট দেখা চালিয়ে যেতে, Google Health API-কে পুনরায় সম্মতি দিন।"
ব্যবহারকারীদের কখন অবহিত করতে হবে
ব্যবহারকারীদের সাথে সকল যোগাযোগের ক্ষেত্রে গুগল হেলথ ব্র্যান্ড নির্দেশিকা মেনে চলুন এবং বাতিলযোগ্য ব্যানার, কার্ড বা অ্যালার্ট ব্যবহার করুন।
- কোনো ব্যবহারকারী যখন ওয়ার্কআউটের মাঝখানে থাকবেন অথবা ম্যানুয়ালি কিছু লগ করবেন, তখন পুনঃসম্মতি স্ক্রিনটি চালু করবেন না।
- কয়েক সপ্তাহ ধরে সতর্ক করার পর, এবং অফিসিয়াল ফিটবিট ওয়েব এপিআই বাতিলের সময়সীমার সাথে মিলিয়ে, পুনরায় সম্মতি বাধ্যতামূলক করুন।
- নির্দিষ্ট সময়সীমার পরেও যদি কোনো ব্যবহারকারী পুনরায় সম্মতি না দেন, তাহলে তাকে একটি স্বাভাবিক পুনরুদ্ধারের পথ দেখান। ব্যানার , কার্ড বা টুলটিপে একটি সহায়ক বার্তা দিন, যা তাদের বুঝতে সাহায্য করবে যে কেন তাদের ডেটা হারিয়ে গেছে এবং কীভাবে এর সমাধান করা যাবে।