গুগল হেলথ এপিআই ব্যবহার করে ধাপে ধাপে অভিজ্ঞতা অর্জন করুন

গুগল হেলথ এপিআই steps ইন্টারভ্যাল’ ডেটা টাইপ ব্যবহার করে ব্যবহারকারীর পদক্ষেপ এবং কার্যকলাপের ডেটা ট্র্যাক করে। পদক্ষেপের সংখ্যা দৈনন্দিন শারীরিক কার্যকলাপের একটি মৌলিক পরিমাপ, যা ডেভেলপারদের ফিটনেসের অগ্রগতি ট্র্যাক করতে, শক্তি ব্যয় গণনা করতে এবং ব্যবহারকারীদের জন্য দৈনন্দিন কার্যকলাপের সারাংশ তৈরি করতে সহায়তা করে।

আপনার ব্যবহারকারীদের সর্বোত্তম অভিজ্ঞতা প্রদানের জন্য, আপনার অ্যাপ্লিকেশনে স্টেপ কাউন্ট মেট্রিক্স কীভাবে পড়তে ও সাজাতে হয় তা বুঝুন।

সমর্থিত ডেটা প্রকার

ধাপ সংখ্যা ট্র্যাক করার জন্য এপিআই নিম্নলিখিত ডেটা টাইপ সমর্থন করে:

সারণি: গুগল হেলথ এপিআই ধাপগুলোর ডেটা টাইপ

ডেটা টাইপ dataType filter প্যারামিটার	রেকর্ড প্রকার	উপলব্ধ অপারেশন	পরিধি	ওয়েবহুক সমর্থন	প্রকৃত শূন্য সমর্থন
পদক্ষেপ steps steps	ব্যবধান	তালিকা, সমন্বয়, একত্রীকরণ, দৈনিক একত্রীকরণ	.activity_and_fitness.readonly .activity_and_fitness.writeonly

নিম্নলিখিত বিভাগগুলিতে steps ডেটা টাইপের প্রযুক্তিগত বিবরণ দেওয়া হয়েছে, যার মধ্যে REST উপস্থাপনার উদাহরণ এবং ইন্টিগ্রেশন নির্দেশিকা অন্তর্ভুক্ত রয়েছে।

প্রয়োজনীয় পরিধি

এই ডেটা টাইপটি অ্যাক্সেস করতে, আপনার অ্যাপকে অবশ্যই নিম্নলিখিত OAuth স্কোপগুলির জন্য অনুরোধ করতে হবে:

• পড়ুন : https://www.googleapis.com/auth/googlehealth.activity_and_fitness.readonly
• লিখুন : https://www.googleapis.com/auth/googlehealth.activity_and_fitness.writeonly

নির্দেশিকা

আপনার অ্যাপে পদক্ষেপ ট্র্যাকিং যুক্ত করার সময়, এই ডিজাইন এবং বাস্তবায়ন নির্দেশিকাগুলো অনুসরণ করুন।

দৈনিক সংক্ষিপ্ত বিবরণ

ভ্রমণ, টাইম জোন পরিবর্তন বা ডেলাইট সেভিংসের কারণে দৈনিক পদক্ষেপের সংখ্যা সঠিকভাবে একত্রিত করতে, ক্লায়েন্ট-সাইডে সময়কাল গণনা করবেন না। এর পরিবর্তে, dailyRollUp এন্ডপয়েন্টটি কোয়েরি করুন, যা UTC অফসেট ব্যবহার করে স্বয়ংক্রিয়ভাবে ভৌত ডেটার ফাঁক পূরণ করে। রোলআপটি একটি StepsRollupValue রিটার্ন করে, যাতে countSum ফিল্ডটি থাকে, যা অনুরোধ করা দিনের জন্য মোট সঞ্চিত পদক্ষেপের সংখ্যা নির্দেশ করে।

ব্যবহারকারী ইন্টারফেস অঙ্কন (সমন্বয়)

স্টেপ ডেটা দেখানোর জন্য ইউজার ইন্টারফেস এলিমেন্ট তৈরি করার সময়, reconcile এন্ডপয়েন্ট ব্যবহার করুন। যদি একাধিক ডেটা সোর্স (যেমন একটি স্মার্টওয়াচ এবং একটি মোবাইল ফোন) একই সময়ে স্টেপ রেকর্ড করে থাকে, তাহলে reconcile এন্ডপয়েন্ট দ্বন্দ্ব সমাধান করে এবং স্ট্রিমগুলিকে একত্রিত করে একটি একক, সমন্বিত ডেটা স্ট্রিম ফেরত দেয়।

ইন্ট্রাডে ট্র্যাকিং এবং হিস্টোগ্রাম

দিনব্যাপী ব্যবহারকারীর কার্যকলাপের বিস্তারিত বিবরণ (যেমন চার্ট এবং গ্রাফ) প্রদর্শন করতে:

• ঘণ্টাভিত্তিক স্টেপ হিস্টোগ্রাম: windowSize প্যারামিটার ব্যবহার করে সময়কাল (যেমন ১ ঘণ্টার জন্য 3600s ) উল্লেখ করে rollUp এন্ডপয়েন্টে কোয়েরি করুন।
• সমস্ত ধাপের রেকর্ড: সবচেয়ে সুনির্দিষ্ট ও মূল ধাপের রেকর্ডগুলো পেতে list এন্ডপয়েন্টটি ব্যবহার করুন।

rollUp এবং reconcile উভয় এন্ডপয়েন্টই dataSourceFamily কোয়েরি প্যারামিটার গ্রহণ করে, যার মাধ্যমে আপনি নির্দিষ্ট সোর্স গ্রুপ থেকে ডেটা ফিল্টার করতে পারেন।

ওয়েবহুক ব্যবহার করে রিয়েল-টাইম সিঙ্ক

নতুন স্টেপ ডেটা ইম্পোর্ট বা সিঙ্ক্রোনাইজ করা হলে রিয়েল টাইমে নোটিফিকেশন পেতে steps ডেটা টাইপ কালেকশনে সাবস্ক্রাইব করুন। REST এন্ডপয়েন্ট পোলিং করার পরিবর্তে, এই ওয়েবহুক নোটিফিকেশনগুলোর প্রতিক্রিয়ায় ক্লায়েন্ট-সাইড ড্যাশবোর্ডগুলো ডায়নামিকভাবে আপডেট করুন। সাবস্ক্রিপশন কীভাবে সেট আপ করতে হয় সে সম্পর্কে বিস্তারিত জানতে, ওয়েবহুক সাবস্ক্রিপশন দেখুন।

প্রকৃত শূন্যগুলি পরিচালনা করুন

Google Health API নিষ্ক্রিয়তার সময়কাল নির্ধারণ করতে ‘ট্রু জিরো’ (true zeros) ব্যবহার করে। যদি কোনো ব্যবহারকারী সক্রিয় থাকেন বা ট্র্যাকার পরে থাকেন কিন্তু না হাঁটেন, তাহলে ট্র্যাকারটি "0" count সহ সুস্পষ্ট পদক্ষেপের ব্যবধান লিখে রাখে। এর মাধ্যমে আপনি সেই সময়কালগুলোর মধ্যে পার্থক্য করতে পারেন, যখন ব্যবহারকারী ডিভাইসটি পরা অবস্থায় শূন্য পদক্ষেপ নিয়েছেন এবং যখন তিনি এটি একেবারেই পরেননি। আরও বিস্তারিত জানতে ‘ডেটা প্রেজেন্স অ্যান্ড ট্রু জিরোস’ (Data presence and true zeros) নির্দেশিকাটি দেখুন।