Google Health API-তে ডেটা নিয়ে কাজ করার মূল বিষয় হল ক্লাউডে Google Health API ডেটাস্টোর এবং আপনার নিজস্ব অ্যাপ বা ব্যাকএন্ড ডেটাস্টোরের মধ্যে ডেটা সিঙ্ক করার একটি চক্র। তবে, বিভিন্ন বিষয়ের উপর নির্ভর করে এই চক্রটি বিভিন্ন রূপ নিতে পারে:
- আপনি কি Google Health API-তে ডেটা লিখছেন? শুধু পড়া? অথবা দুটিই করছেন?
- আপনার ডেটাস্টোর কি অ্যাপ বা ডিভাইসে লোকাল? অথবা আপনার নিজের ক্লাউডে?
- ব্যবহারকারীর অ্যাপ এবং পরে থাকা যায় এমন ডিভাইসের মধ্যে Google Health API ডেটা সিঙ্ক করতে হবে? আপনি কত ঘন ঘন ডিভাইস সিঙ্ক করেন?
- আপনি কোন ধরনের ডেটা নিয়ে কাজ করছেন? বেসিক গণনা? পরিমাপের একক? বিভিন্ন স্যাম্পেলিং রেট সহ সিরিজ?
- আপনার অ্যাপ ব্যাকগ্রাউন্ডে থাকাকালীন আপনি কি ডেটা পড়ার পরিকল্পনা করছেন?
- আপনার অ্যাপ ব্যবহারকারীর অনুমতি পাওয়ার আগে রেকর্ড করা পুরনো ডেটা নিয়ে কাজ করার কোনও পরিকল্পনা আছে কি?
এইসব কীভাবে একসাথে কাজ করে তা বুঝতে, Google Health API সিঙ্ক লাইফসাইকেল দেখুন। এই লাইফসাইকেলের দুটি ভার্সন আছে: স্ট্যান্ডার্ড (রিড ও রাইট) এবং রিড-অনলি।
স্ট্যান্ডার্ড সিঙ্ক লাইফসাইকেল
Google Health API-এর সাথে ইন্টিগ্রেট করার অর্থ হল কোনও অ্যাপ বা ব্যাকএন্ড ডেটাস্টোরে ডেটা কপি করা। এই ডকুমেন্টেশনে সহজে ব্যবহার করার জন্য, আমরা এই ডেটাস্টোরকে ডেভেলপার ডেটাস্টোর বলব।
এখানে "কপি" বলতে যেকোনও বিচ্ছিন্ন অ্যাক্টিভিটি বোঝানো হতে পারে, যেমন Google Health API থেকে পড়া (ডেভেলপার ডেটাস্টোরে কপি করা) বা Google Health API-তে লেখা (Google Health API-তে কপি করা)। নির্দিষ্ট ক্রমে বারবার এইসব অ্যাকশন সম্পূর্ণ করাকেই সিঙ্ক লাইফসাইকেল বলা হয়।
আগে উল্লেখ করা কোনও বিষয় বিবেচনা না করেই, ছবি ১-এ স্ট্যান্ডার্ড সিঙ্ক লাইফসাইকেল দেখানো হয়েছে, যার মধ্যে রিড ও রাইট অপারেশন অন্তর্ভুক্ত।
লিখুন
- লেখার জন্য নতুন ডেটা প্রস্তুত করা — কোনও এক্সটার্নাল ডিভাইস বা অ্যাপ থেকে ডেটা ট্রান্সফার করা এবং ডেটা পয়েন্টগুলিকে Google Health API ডেটার ধরনের সাথে মানানসই JSON রিপ্রেজেন্টেশনে ফর্ম্যাট করা। মনে রাখবেন, লেখার জন্য কাস্টম ক্লায়েন্ট-অ্যাসাইন করা আইডি
এই মুহূর্তে Health API-তে কাজ করে না। এই ধরনের আইডি
POST-এ দেওয়া হতে পারে, তবে সেগুলি উপেক্ষা করা হয়। - রেকর্ড আপসার্ট করা — REST এন্ডপয়েন্ট ব্যবহার করে Google Health API-তে ডেটা পয়েন্ট জমা দিন। রেকর্ড তৈরি করতে
POSTএবং আগে থেকে থাকা রেকর্ড আপডেট করতেPATCHব্যবহার করুন।PATCHঅপারেশনের জন্য প্রয়োজনীয় আইডি আগেরPOSTঅপারেশন (আগের সাইকেলের পরবর্তী ধাপ) থেকে আসে। - প্রসেস রিটার্ন করা রিসোর্স আইডি — সার্ভার-জেনারেটেড আইডি ব্যবহার করার সময়,
ভবিষ্যতে আপডেট (
PATCH) বা মুছে ফেলার সুবিধা চালু করতে, আপনার ডেভেলপার ডেটাস্টোরে সার্ভার-রিটার্ন করা রিসোর্সnameবা আইডি এক্সট্র্যাক্ট ও পারসিস্ট করুন। দুটি ধরন সম্পর্কে আরও তথ্যের জন্য শনাক্তকরণ স্ট্র্যাটেজি দেখুন।
পড়ুন
- রেকর্ড পড়া — REST এন্ডপয়েন্ট (
GET-এর সাথেfilterকোয়েরি প্যারামিটার এবংpageTokenপৃষ্ঠা সংখ্যা, অথবাrollUpএবংdailyRollUp-এর মতো অ্যাগ্রিগেশন এন্ডপয়েন্ট) ব্যবহার করে Google Health API-তে নতুন ডেটা এবং বর্তমান ডেটায় পরিবর্তন ফেচ করা, অথবা Webhook সাবস্ক্রিপশন (projects.subscribers) ব্যবহার করে বিজ্ঞপ্তি পাওয়া। বিজ্ঞপ্তি থেকে শুধু বোঝা যায় যে নতুন ডেটা উপলভ্য আছে, আসল ডেটা কী তা বোঝা যায় না। - ডেভেলপার ডেটাস্টোর রিকনসাইল করা — আপনার ডেভেলপার ডেটাস্টোরে নতুন ও আপডেট করা ডেটা রিকনসাইল করুন। কানেক্ট করা ডিভাইস সিঙ্ক করার সময় ওভারল্যাপ করা ইন্টারভ্যাল তৈরি করতে পারে। Google Health API কীভাবে এগুলি সমাধান করে তা জানতে, ইন্টারভ্যাল টাইমস্ট্যাম্প ও কানেক্ট করা ডিভাইস সিঙ্ক করা দেখুন।
এক্সটার্নাল ডিভাইস বা অ্যাপের নির্দিষ্ট প্রয়োজন অনুযায়ী এই চক্রটি উপযুক্ত বিরতিতে পুনরাবৃত্তি হয়। আপনার নিজস্ব ডেটাস্টোর এবং Google Health API-এর মধ্যে ডেটা সিঙ্ক করার জন্য আমরা সাধারণত এই ক্রমটি সাজেস্ট করি।
শনাক্তকরণ স্ট্র্যাটেজি
আপনি Google Health API-তে ডেটা লিখতে চাইলে, Google Health API-এর সাথে আপনার ইন্টিগ্রেশন তৈরি করার আগে, ডেটা পয়েন্ট (ডেটার মৌলিক ইউনিট) তৈরি করার সময় আপনাকে অবশ্যই একটি রিসোর্স শনাক্তকরণ কৌশল বেছে নিতে হবে।
এই মুহূর্তে Health API-তে লেখার জন্য ক্লায়েন্ট-অ্যাসাইন করা আইডি কাজ করে না।
এই ধরনের আইডি POST-এ প্রদান করা হতে পারে, তবে সেগুলি উপেক্ষা করা হয়। এই বিকল্পের বিবরণ
এখানে শুধুমাত্র তথ্য দেওয়ার উদ্দেশ্যে প্রদান করা হয়েছে।
- সার্ভার-জেনারেটেড আইডি (ডিফল্ট বিকল্প): ক্লায়েন্ট আইডি ছাড়াই ডেটা জমা দেয় এবং Google Health API ব্যাকএন্ড একটি অনন্য সিস্টেম আইডেন্টিফায়ার জেনারেট করে এবং ফেরত দেয়।
- ক্লায়েন্ট-অ্যাসাইন করা কাস্টম আইডি (AIP-133 অনুযায়ী, এখনও কাজ করে না): ক্লায়েন্ট অ্যাপ একটি অনন্য শনাক্তকারী (যেমন, একটি UUID বা লোকাল ডেটাবেস প্রাইমারি কী) তৈরি করে এবং তৈরি করার সময় রিসোর্স পাথে এটি প্রদান করে।
আপনার ইন্টিগ্রেশনের জন্য সঠিক পদ্ধতি বেছে নিতে সাহায্য করার জন্য নিম্নলিখিত সারণীটি উভয় শনাক্তকরণ কৌশলের তুলনা করে:
| ফিচার | সার্ভার-জেনারেটেড আইডি | ক্লায়েন্ট-অ্যাসাইন করা কাস্টম আইডি |
|---|---|---|
| আইডি জেনারেশন | POST
এক্সিকিউশনের সময় সার্ভার র্যান্ডম সিস্টেম আইডি তৈরি করে। |
ক্লায়েন্ট স্থানীয়ভাবে (UUID v4 / ইন্টার্নাল PK) স্টেবল আইডি জেনারেট করে লেখার আগে। |
| রিসোর্স পাথ | .../dataPoints/{server_id} (উত্তরে ফেরত এসেছে) |
.../dataPoints/{custom_id} |
| পোস্ট-রাইট লোকাল স্টেপ | প্রয়োজনীয়। ভবিষ্যতে আপডেট/মুছে ফেলার সুবিধা চালু করতে,
ফেরত আসা server_id অবশ্যই লোকাল DB-তে স্টোর করতে হবে। |
কিছুই নয়। অ্যাপের কাছে আগে থেকেই আইডি আছে। |
| আইডি ম্যাপিং টেবিল | প্রয়োজনীয়। ক্লায়েন্টকে অবশ্যই ২-ওয়ে ম্যাপিং বজায় রাখতে হবে
(local_id ↔ server_id)। |
প্রয়োজন নেই। ক্লায়েন্ট সরাসরি নিজের প্রাথমিক কী ব্যবহার করে। |
| আবার চেষ্টা করার আচরণ (দুর্বল নেটওয়ার্ক) | ডুপ্লিকেট হওয়ার ঝুঁকি। টাইম-আউট হয়ে যাওয়া POST আবার চেষ্টা করলে
নতুন সার্ভার আইডি সহ ডুপ্লিকেট রেকর্ড তৈরি হয়। |
নিরাপদ ও আইডেমপোটেন্ট। একই custom_id দিয়ে POST আবার চেষ্টা করলে
ডুপ্লিকেট তৈরি হওয়া আটকানো যায় (409
ALREADY_EXISTS রিটার্ন করে)। |
| অফলাইন সিঙ্ক সহায়তা | সীমিত। অফিসিয়াল রিসোর্স আইডি রেফারেন্স করার আগে তা পাওয়ার জন্য সার্ভারের উত্তরের অপেক্ষা করতে হবে। | সম্পূর্ণ। অফলাইনে স্টেবল আইডি ব্যবহার করে এন্টিটি তৈরি ও পরিবর্তন করা যায়, তারপর আবার কানেক্ট করা হলে নির্বিঘ্নে সিঙ্ক করা যায়। |
| ফর্ম্যাট সংক্রান্ত সীমাবদ্ধতা | সার্ভার দ্বারা সম্পূর্ণভাবে ম্যানেজ করা হয়। | ^[a-z0-9-]{4,63}$ (৪–৬৩টি ছোট হাতের
বর্ণসাংখ্যিক অক্ষর ও হাইফেন) মেনে চলতে হবে। |
| কখন বেছে নিতে হবে |
সার্ভার-জেনারেটেড আইডি বেছে নিন যদি:
|
কাস্টম আইডি বেছে নিন যদি:
|
শুধু পড়া যাবে এমন সিঙ্ক লাইফসাইকেল
যে অ্যাপ শুধুমাত্র Google Health API থেকে ডেটা পড়তে চায়, সেটিকে অবশ্যই ডেটা কপি করে ডেভেলপার ডেটাস্টোরে রাখতে হবে এবং লাইফসাইকেলের রিকনসিলিয়েশন অংশ ম্যানেজ করতে হবে।
পড়ুন বিভাগে যে টাস্কগুলি কভার করা হয়েছে সেগুলি এখানেও প্রযোজ্য।
ছবি ২-এ শুধু-পড়া যায় এমন লাইফসাইকেল দেখানো হয়েছে।
ইন্টারভ্যাল টাইমস্ট্যাম্প ও কানেক্ট করা ডিভাইস সিঙ্ক করা
ইন্টারভ্যাল ডেটা বলতে নির্দিষ্ট সময়সীমা জুড়ে সংগ্রহ করা পরিমাপকে বোঝায়, যেমন স্টেপ, হার্ট রেট বা এক্সারসাইজ সেশন। অন্যদিকে, পয়েন্ট-ইন-টাইম পরিমাপের মধ্যে ফুড লগ বা স্কেল রিডিংয়ের মতো ম্যানুয়াল এন্ট্রি অন্তর্ভুক্ত থাকে। ইন্টারভাল ডেটা সাধারণত স্মার্টওয়াচ ও ফিটনেস ট্র্যাকারের মতো কানেক্ট করা ডিভাইস সিঙ্ক করার মাধ্যমে তৈরি হয়।
ইন্টারভাল টাইমস্ট্যাম্প (REST JSON পেলোডে startTime এবং endTime, অথবা
ফিল্টার এক্সপ্রেশন এবং gRPC-তে start_time এবং end_time) ইন্টারভাল ডেটা নিয়ে কাজ করার সময়
অনন্য আচরণ দেখায়। এই বিভাগে ওভারল্যাপ করা ইন্টারভ্যাল কেন হয় তা ব্যাখ্যা করা হয়েছে এবং list ও reconcile এন্ডপয়েন্টের তুলনা করা হয়েছে।
কানেক্ট করা ডিভাইস থেকে ওভারল্যাপ করা ইন্টারভাল
Fitbit ট্র্যাকার এবং Google Pixel Watch-এর মতো কানেক্ট করা ডিভাইসগুলি পরা অবস্থায় ক্রমাগত হাই-ফ্রিকোয়েন্সি বায়োমেট্রিক রিডিং সংগ্রহ করে। কোনও ডিভাইস Google Health-এ ডেটা পয়েন্ট সিঙ্ক করার পরে, এটি আগে থেকে থাকা রেকর্ডগুলি পূর্ববর্তী তারিখ থেকে পরিবর্তন করে না। তাদের স্টোর করা ইন্টারভ্যাল টাইমস্ট্যাম্প অপরিবর্তিত থাকে।
তবে, পরবর্তী সিঙ্ক সাইকেলের আগে, অন-ডিভাইস অ্যালগরিদম প্রায়ই র-সেন্সর টেলিমেট্রি পুনরায় ব্যাখ্যা করে। ডিভাইসটি আগের কয়েক ঘণ্টা ধরে সংগ্রহ করা রিডিং আবার বাকেট করে। ডিভাইস আবার সিঙ্ক হলে, এটি নতুন ডেটা পয়েন্ট আপলোড করে। সেগুলির শুরু ও শেষের সীমানা আগে থেকে সেভ করা ইন্টারভ্যালের সাথে ওভারল্যাপ করতে পারে।
যেমন, ধরুন কোনও ব্যবহারকারী স্মার্টওয়াচ পরে আছেন এবং তার অ্যাক্টিভিটি ডেটা পরপর দুটি ব্যাচে সিঙ্ক করা হয়েছে:
- প্রথমবার সিঙ্ক করার সময়, ডিভাইস
10:00:00Zথেকে10:14:59Zপর্যন্ত ডেটা পয়েন্ট আপলোড করে। - অন-ডিভাইস রিক্যালকুলেশনের পরে, দ্বিতীয় সিঙ্ক আরেকটি ডেটা পয়েন্ট আপলোড করে
যা
10:14:00Zথেকে10:28:59Zকভার করে।
দুটি রেকর্ডই Google Health ব্যাকএন্ডে আলাদাভাবে স্টোর করা হয়। এর ফলে, দুটি ডেটা পয়েন্টই 10:14:00Z থেকে 10:14:59Z পর্যন্ত সময়সীমা কভার করে।
এর ফলে র-রেকর্ড কোয়েরি করার সময় ৫৯ সেকেন্ডের ওভারল্যাপ হয়।
তালিকা তুলনা করুন এবং এন্ডপয়েন্ট রিকনসাইল করুন
আপনি list অথবা
reconcile এন্ডপয়েন্ট ব্যবহার করে এইসব ওভারল্যাপ করা ইন্টারভ্যাল ম্যানেজ করতে পারবেন। আপনার অ্যাপ্লিকেশনের প্রয়োজনীয়তার সাথে মেলে এমন এন্ডপয়েন্ট
বেছে নিন:
| ফিচার | listটি এন্ডপয়েন্ট |
reconcileটি এন্ডপয়েন্ট |
|---|---|---|
| HTTP পদ্ধতি | GET https://health.googleapis.com/v4/users/me/dataTypes/dataType/dataPoints |
GET https://health.googleapis.com/v4/users/me/dataTypes/dataType/dataPoints:reconcile |
| ওভারল্যাপ সংক্রান্ত আচরণ | আপলোড করা সব রেকর্ড ডুপ্লিকেট না করে দেখায়। ইন্টারভ্যাল ওভারল্যাপ করলে, দুটি রেকর্ডই ফেরত দেওয়া হয়। | ডিভাইস ও সিঙ্ক সেশন জুড়ে ওভারল্যাপ করা রেকর্ডগুলির মধ্যে দ্বন্দ্ব সমাধান করে এবং ডুপ্লিকেট রেকর্ডগুলি সরিয়ে দেয়, যাতে একটি অবিচ্ছিন্ন স্ট্রিম তৈরি করা যায়। |
| সুবিধা | প্রতিটি ডিভাইস ও সিঙ্ক ব্যাচের মাধ্যমে আপলোড করা প্রতিটি রেকর্ডের সম্পূর্ণ, অপরিবর্তিত অডিট ট্রেল প্রদান করে। | ওভারল্যাপ করা ইন্টারভাল ও মাল্টি-ডিভাইস সংক্রান্ত সমস্যা অটোমেটিক ম্যানেজ করার মাধ্যমে টাইমলাইন রেন্ডারিং ও সময়সীমা গণনা করার প্রসেসকে সহজ করে তোলে। |
| অসুবিধা | ওভারল্যাপ করা ইন্টারভাল, মাল্টি-ডিভাইস কনফ্লিক্ট এবং অফ-রিস্ট পিরিয়ড শনাক্ত ও সমাধান করার দায়িত্ব আপনার অ্যাপ্লিকেশনের। | সাবঅর্ডিনেট ওভারল্যাপ করা রেকর্ড উত্তর থেকে বাদ দেওয়া হয়, তাই আলাদা আলাদা ডিভাইস সিঙ্ক ব্যাচ আলাদাভাবে অডিট করা যায় না। |
reconcile এন্ডপয়েন্টটি ইউজার ইন্টারফেস আঁকা, অ্যাক্টিভিটি টাইমলাইন রেন্ডার করা এবং
ওভারল্যাপ না করা মোট সময় গণনা করার জন্য ডিজাইন করা হয়েছে। এটি রি-বাকেট করা সিঙ্ক সেশন থেকে
কনফ্লিক্টিং ইন্টারভ্যাল সমাধান করে। এছাড়াও, এটি একাধিক ডিভাইসে (যেমন, স্মার্টওয়াচ ও ফোন) একই সাথে লগ করা অ্যাক্টিভিটি
রিকনসাইল করে।
রিকনসিলিয়েশন, কৃত্রিম সময় ইউনিয়ন সিন্থেসাইজ করার পরিবর্তে অথরিটেটিভ রেকর্ড বেছে নিয়ে
কনফ্লিক্টিং সেশন সমাধান করে। যেমন, এটি 11:00:00Z থেকে 11:30:00Z এবং 11:20:00Z থেকে 11:50:00Z-কে
11:00:00Z থেকে 11:50:00Z-এর মধ্যে
মার্জ করে না। রিকনসাইল করা উত্তরটি আসল রেকর্ড করা ইন্টারভ্যাল সহ
জয়ী ডেটা পয়েন্ট ফিরিয়ে দেয়। এটি সেই সেশনের পরিমাপ করা টেলিমেট্রি এবং মেট্রিক্সের
ইন্টিগ্রিটি বজায় রাখে।
reconcile এন্ডপয়েন্ট কীভাবে ওভারল্যাপ করা সেশন ম্যানেজ করে তা ছবি ৩-এ দেখানো হয়েছে।
এটি কৃত্রিম সময় ইউনিয়ন তৈরি করার পরিবর্তে প্রামাণ্য রেকর্ড বেছে নেয়।
এন্ডপয়েন্ট সংক্রান্ত নির্দেশিকায় সম্পূর্ণ অনুরোধ ও উত্তরের উদাহরণ দেওয়া আছে। reconcile আউটপুটের সাথে
র list রেকর্ড তুলনা করতে,
ইন্টারভ্যাল ডেটার রিকনসাইল করা ভিউ পান দেখুন।
list এন্ডপয়েন্টটি ডিভাইস ডায়াগনস্টিকস ও ডেটা অডিটের জন্য ডিজাইন করা হয়েছে। আপনার ওয়ার্কফ্লোতে প্রতিটি ডিভাইস থেকে আপলোড করা অপরিবর্তিত রেকর্ড পরীক্ষা করার প্রয়োজন হলে
এটি ব্যবহার করুন। list-এর মাধ্যমে কোয়েরি করার সময়, আপনার ক্লায়েন্ট লজিককে অবশ্যই র ডেটাতে যেকোনও ইন্টারভাল
ওভারল্যাপ ম্যানেজ করতে হবে।
টাইমস্ট্যাম্পের পরিবর্তনশীলতা এবং মালিকের আপডেট
কানেক্ট করা ডিভাইস, সাধারণ সিঙ্ক সাইকেল চলাকালীন, আগে থেকে স্টোর করা টাইমস্ট্যাম্প
পরিবর্তন করে না। তবে, ইন্টারভ্যাল টাইমস্ট্যাম্প (REST JSON পেলোডে startTime এবং endTime,
অথবা ফিল্টার এক্সপ্রেশন এবং gRPC-তে start_time এবং end_time)
সব ডেটা সোর্স জুড়ে সর্বজনীনভাবে অপরিবর্তনীয় নয়। কোনও রেকর্ডের আসল
ক্রিয়েটর বা মালিকই শুধু তার ফিল্ড পরিবর্তন করতে পারবেন। অন্যান্য অ্যাপ্লিকেশন, তাদের তৈরি করা নয় এমন ডেটা পয়েন্ট
এডিট করতে পারবে না।
মালিকের অ্যাপ্লিকেশন
patch এন্ডপয়েন্ট ব্যবহার করে
আগে থেকে থাকা রেকর্ড আপডেট করতে পারে। এর মধ্যে শুরু বা শেষের টাইমস্ট্যাম্প পরিবর্তন করা অন্তর্ভুক্ত,
যা সার্ভারে UTC (startTime এবং endTime) এবং সিভিল টাইম
(civilStartTime এবং civilEndTime) ফিল্ড দুটিই আপডেট করে। PATCH-এর মাধ্যমে টাইমস্ট্যাম্প আপডেট করার উদাহরণ দেখতে,
এন্ডপয়েন্ট গাইডে
আগে থেকে থাকা ডেটার জন্য ইন্টারভাল টাইমস্ট্যাম্প আপডেট করুন
বিকল্প দেখুন।
একইভাবে, Health Connect বা পার্টনার অ্যাপের মতো এক্সটার্নাল প্ল্যাটফর্ম থেকে সিঙ্ক করা ডেটা পয়েন্ট, যে সোর্স থেকে ডেটা নেওয়া হয়েছে সেখান থেকে আপডেট পায়। Health Connect যদি পরে আসল থার্ড-পার্টি অ্যাপ থেকে সিঙ্ক করা রেকর্ডের জন্য কোনও আপডেট পায়, তাহলে সেই পরিবর্তনগুলি আগের রেকর্ডকে ওভাররাইট করে।