ডেটা প্রকার

গুগল ফিট com.google নেমস্পেসের অধীনে স্বাস্থ্য ও সুস্থতা বিষয়ক বিভিন্ন ডেটা টাইপ প্রদান করে।

ডেটা টাইপ ডেটা পয়েন্টের ভেতরের মানগুলোর বিন্যাস নির্ধারণ করে। একটি ডেটা পয়েন্ট যা যা উপস্থাপন করতে পারে:

• একটি তাৎক্ষণিক পাঠ বা পর্যবেক্ষণ
• একটি নির্দিষ্ট সময় ব্যবধানের পরিসংখ্যান সহ একটি সমষ্টি।

গুগল ফিট তাৎক্ষণিক পর্যবেক্ষণের জন্য ডেটা টাইপ এবং সমষ্টিগত ডেটার জন্য ডেটা টাইপ নির্ধারণ করে। ডেটা পয়েন্টগুলো একটি ডেটা টাইপের ফিল্ডগুলোর মান এবং টাইমস্ট্যাম্প তথ্য নিয়ে গঠিত। যে পয়েন্টগুলো তাৎক্ষণিক পর্যবেক্ষণকে প্রতিনিধিত্ব করে, সেগুলোতে একটি টাইমস্ট্যাম্প থাকে এবং সমষ্টিগত ডেটা টাইপের পয়েন্টগুলোতে নির্দিষ্ট সময়কালের শুরুর সময়ও অন্তর্ভুক্ত থাকে।

Google Fit আপনাকে নতুন ডেটা টাইপ নির্ধারণ করার সুযোগও দেয়।

ডেটা টাইপ গ্রুপ

গুগল ফিট-এ এই ডেটা টাইপগুলো রয়েছে:

পাবলিক ডেটা টাইপ

প্ল্যাটফর্ম দ্বারা প্রদত্ত স্ট্যান্ডার্ড ডেটা টাইপগুলোর শুরুতে 'com.google' প্রিফিক্স থাকে। উদাহরণস্বরূপ, com.google.step_count.delta । এই ডেটা টাইপগুলো স্বাস্থ্য ও সুস্থতা সম্পর্কিত ডেটার তাৎক্ষণিক রিডিং সংগ্রহ করে, যার মধ্যে ফিটনেস অ্যাক্টিভিটি, ঘুম এবং পুষ্টি অন্তর্ভুক্ত। যেকোনো অ্যাপ এই ডেটা টাইপগুলোতে পড়া এবং লেখার জন্য প্রাসঙ্গিক অনুমতির অনুরোধ করতে পারে, তবে কয়েকটি লোকেশন ডেটা টাইপ এর ব্যতিক্রম, যেগুলো শুধুমাত্র সেই অ্যাপই পড়তে পারে যেটি সেগুলো লিখেছে।

আরও তথ্যের জন্য দেখুন:

• কার্যকলাপের ডেটা প্রকার
• অবস্থান ডেটা প্রকার
• পুষ্টি তথ্যের প্রকার

স্বাস্থ্য ডেটার প্রকার

প্ল্যাটফর্ম কর্তৃক প্রদত্ত ডেটার প্রকারভেদ, যেগুলোতে সম্ভাব্য সংবেদনশীল তথ্য থাকার কারণে প্রবেশাধিকার সীমিত। আরও তথ্যের জন্য, স্বাস্থ্য ডেটার প্রকারভেদ দেখুন।

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

সময় বা কার্যকলাপের ধরন অনুযায়ী একত্রিত স্বাস্থ্য ও সুস্থতা বিষয়ক তথ্য পড়ার জন্য ডেটা টাইপসমূহ। আরও তথ্যের জন্য, অ্যাগ্রিগেট ডেটা টাইপস দেখুন।

ব্যক্তিগত কাস্টম ডেটা টাইপ

একটি নির্দিষ্ট অ্যাপ দ্বারা সংজ্ঞায়িত কাস্টম ডেটা টাইপ। শুধুমাত্র যে অ্যাপটি ডেটা টাইপটি সংজ্ঞায়িত করে, সেটিই এই ধরনের ডেটা পড়তে এবং লিখতে পারে। আরও তথ্যের জন্য, কাস্টম ডেটা টাইপস দেখুন।

ডেটা টাইপ ব্যবহার করে

দ্রষ্টব্য: একই স্ট্রিমের ডেটা পয়েন্টগুলোর সময়সীমা যেন ওভারল্যাপ না করে! যদি তা হয়, তাহলে ওভারল্যাপ হওয়া সময়ের ডেটা বাদ পড়ে যাবে, যার ফলে প্রত্যাশিত এবং প্রদর্শিত মানের মধ্যে অমিল দেখা দিতে পারে।

অ্যান্ড্রয়েড

অ্যান্ড্রয়েডে, ডেটা টাইপগুলোকে DataType ক্লাসের পাবলিক ফিল্ড হিসেবে সংজ্ঞায়িত করা হয়। আপনি কী অর্জন করতে চান, তার উপর নির্ভর করে ডেটা টাইপ ব্যবহার করে ফিটনেস এপিআইগুলোকে কীভাবে কল করবেন:

• ডেটা রেকর্ড করতে, আপনি যে প্রতিটি ডেটা টাইপ রেকর্ড করতে চান তার জন্য রেকর্ডিং এপিআই (Recording API) ব্যবহার করে একটি সাবস্ক্রিপশন তৈরি করুন।
• ডেটা পড়ার জন্য, হিস্ট্রি এপিআই ব্যবহার করে প্রতিটি ডেটা টাইপের জন্য একটি রিড রিকোয়েস্ট সাবমিট করুন।
• অতীতের ঐতিহাসিক ডেটা সন্নিবেশ করতে, প্রতিটি ডেটা টাইপের জন্য একটি সন্নিবেশ অনুরোধ জমা দিতে হিস্ট্রি এপিআই (History API) ব্যবহার করুন।
• সেশন তৈরি করতে, সেশন মেটাডেটা সহ ডেটা সন্নিবেশ বা রেকর্ড করার জন্য সেশনস এপিআই ব্যবহার করুন।

একটি ইনস্ট্যানসিয়াস DataType অবজেক্টের জন্য ডেটা পয়েন্ট তৈরি করতে, সঠিক ফরম্যাটে মান নির্ধারণ করুন। নিম্নলিখিত উদাহরণটি দেখায় কিভাবে খাদ্যদ্রব্যকে স্ট্রিং হিসাবে, খাবারের ধরণকে Field ক্লাস থেকে একটি ধ্রুবক হিসাবে, এবং পুষ্টি উপাদানগুলিকে ম্যাপ করা ফ্লোট মান হিসাবে নির্ধারণ করতে হয়।

val nutritionSource = DataSource.Builder()
    .setDataType(DataType.TYPE_NUTRITION)
    ...
    .build()

val nutrients = mapOf(
    Field.NUTRIENT_TOTAL_FAT to 0.4f,
    Field.NUTRIENT_SODIUM to 1f,
    Field.NUTRIENT_POTASSIUM to 422f
)
val banana = DataPoint.builder(nutritionSource)
    .setTimestamp(now, TimeUnit.MILLISECONDS)
    .setField(Field.FIELD_FOOD_ITEM, "banana")
    .setField(Field.FIELD_MEAL_TYPE, Field.MEAL_TYPE_SNACK)
    .setField(Field.FIELD_NUTRIENTS, nutrients)
    .build()

আপনার অ্যাপে ডেটা পয়েন্ট সেট করার পর, আপনি হিস্ট্রি এপিআই (History API) ব্যবহার করে ঐতিহাসিক ডেটা সন্নিবেশ, পাঠ বা মুছে ফেলতে পারেন।

বিশ্রাম

dataSources রিসোর্সটিতে প্রতিটি ডেটা সোর্সের জন্য ডেটা টাইপ (এবং এর ফিল্ডগুলোর একটি তালিকা) অন্তর্ভুক্ত থাকে। ডেটা সোর্স তৈরি করার সময় আপনি এই ডেটা টাইপগুলোর মধ্যে একটি নির্দিষ্ট করে দিতে পারেন, এবং ফিটনেস স্টোর থেকে কোনো ডেটা সোর্স পুনরুদ্ধার করার সময় আপনি ডেটা টাইপের নাম ও এর ফিল্ডগুলোর তালিকা পেতে পারেন।

উদাহরণস্বরূপ, একটি ডেটা সোর্স রিপ্রেজেন্টেশন তার ডেটা টাইপকে নিম্নরূপে নির্দিষ্ট করে:

{
"dataStreamId": "exampleDataSourceId",
...
"dataType": {
  "name": "com.google.step_count.delta"
},
...
}

অনুমোদনের পরিধি

অথরাইজেশন স্কোপ বা অনুমোদনের পরিধি এমন সব ডেটা টাইপের সমষ্টিকে অন্তর্ভুক্ত করে, যেগুলোকে কোনো অ্যাপ অ্যাক্সেস করার জন্য ব্যবহারকারী অনুমোদন দিতে পারেন। এগুলো ব্যবহারকারীদের বুঝতে সাহায্য করে যে একটি অ্যাপ কোন ধরনের ডেটা অ্যাক্সেস করতে চায়। এছাড়াও, প্রতিটি ডেটা টাইপকে আলাদাভাবে অনুমোদন করার প্রয়োজন না হওয়ায়, অ্যাপগুলোকে সেই ডেটা ব্যবহারের অনুমতি দেওয়াও সহজ হয়ে যায়। ব্যবহারকারীরা আপনার অ্যাপটি ডাউনলোড করার পরেই এই অনুমতিগুলো প্রদান করেন।

চিত্র ২. OAuth স্কোপ সম্মতি স্ক্রিন।

অল্প সংখ্যক ব্যবহারকারীর সাথে আপনার অ্যাপটি পরীক্ষা করার পর, অ্যাপটি চালু করার আগে আপনাকে সেই ডেটা টাইপগুলোর সাথে প্রাসঙ্গিক স্কোপগুলোর উপর ভিত্তি করে যাচাইকরণের অনুরোধ করতে হবে। প্রতিটি ডেটা টাইপের জন্য কোন স্কোপগুলো প্রযোজ্য তা বোঝার জন্য উপরে লিঙ্ক করা ডেটা টাইপের পৃষ্ঠাগুলো ভালোভাবে পড়ুন।

উদাহরণস্বরূপ, যদি আপনার অ্যাপের রক্তচাপের ডেটা পড়া এবং লেখার প্রয়োজন হয়, তবে এটিকে ঘোষণা করতে হবে যে এটি পড়া এবং লেখা উভয়ই করছে এবং উভয় স্কোপের জন্যই অনুরোধ করতে হবে। যদি এটি শুধুমাত্র গুগল ফিট প্ল্যাটফর্মে রক্তচাপের ডেটা লেখে, তবে এটিকে কেবল রাইট স্কোপের জন্য অনুরোধ করতে হবে।

দায়িত্বের সাথে ডেটা টাইপ বেছে নিন। আপনার অ্যাপের প্রয়োজন হতে পারে ভেবে সব ডেটা টাইপের জন্য অনুরোধ করবেন না। নির্দিষ্ট করা টাইপগুলোই নির্ধারণ করে দেয় যে ব্যবহারকারীকে কোন কোন স্কোপের জন্য অনুমতি দিতে বলা হবে। শুধুমাত্র আপনার অ্যাপের প্রয়োজনীয় ডেটা টাইপগুলোর জন্যই অনুরোধ করুন, যাতে ব্যবহারকারীরা অ্যাক্সেস দেওয়ার সম্ভাবনা বেশি থাকে। ব্যবহারকারীরা সীমিত ও সুস্পষ্টভাবে বর্ণিত স্কোপগুলোতে আরও সহজে অ্যাক্সেস দিয়ে থাকেন।

আপনার অ্যাপের অ্যাক্সেস প্রয়োজন এমন স্কোপগুলো সংবেদনশীল বা সীমাবদ্ধ কিনা তা যাচাই করতে এই সারণিটি ব্যবহার করুন (যা আপনাকে অনুসরণ করতে হবে এমন যাচাইকরণ ধাপগুলো নির্ধারণ করবে):

পরিধি	বর্ণনা	বিভাগ
https://www.googleapis.com/auth/fitness.activity.read	গুগল ফিট প্ল্যাটফর্ম থেকে কার্যকলাপের ডেটা পড়ুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.activity.write	Google Fit প্ল্যাটফর্মে কার্যকলাপের ডেটা লিখুন	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.blood_glucose.read	গুগল ফিট প্ল্যাটফর্ম থেকে রক্তের গ্লুকোজের ডেটা পড়ুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.blood_glucose.write	গুগল ফিট প্ল্যাটফর্মে রক্তের গ্লুকোজের তথ্য লিখুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.blood_pressure.read	গুগল ফিট প্ল্যাটফর্ম থেকে রক্তচাপের তথ্য পড়ুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.blood_pressure.write	গুগল ফিট প্ল্যাটফর্মে রক্তচাপের তথ্য লিখুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.body.read	গুগল ফিট প্ল্যাটফর্ম থেকে শরীরের পরিমাপের তথ্য (উচ্চতা, ওজন, শরীরের চর্বির শতাংশ) পড়ুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.body.write	গুগল ফিট প্ল্যাটফর্মে শরীরের পরিমাপের ডেটা লিখুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.body_temperature.read	গুগল ফিট প্ল্যাটফর্ম থেকে শরীরের তাপমাত্রার ডেটা পড়ুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.body_temperature.write	গুগল ফিট প্ল্যাটফর্মে শরীরের তাপমাত্রার ডেটা লিখুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.heart_rate.read	গুগল ফিট প্ল্যাটফর্ম থেকে হৃদস্পন্দনের ডেটা পড়ুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.heart_rate.write	গুগল ফিট প্ল্যাটফর্মে হৃদস্পন্দনের ডেটা লিখুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.location.read	গুগল ফিট প্ল্যাটফর্ম থেকে অবস্থানের ডেটা পড়ুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.location.write	গুগল ফিট প্ল্যাটফর্মে অবস্থানের ডেটা লিখুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.nutrition.read	গুগল ফিট প্ল্যাটফর্ম থেকে পুষ্টি সংক্রান্ত তথ্য পড়ুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.nutrition.write	গুগল ফিট প্ল্যাটফর্মে পুষ্টি সংক্রান্ত তথ্য লিখুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.oxygen_saturation.read	গুগল ফিট প্ল্যাটফর্ম থেকে অক্সিজেন স্যাচুরেশন ডেটা পড়ুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.oxygen_saturation.write	গুগল ফিট প্ল্যাটফর্মে অক্সিজেন স্যাচুরেশন ডেটা লিখুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.reproductive_health.read	গুগল ফিট প্ল্যাটফর্ম থেকে প্রজনন স্বাস্থ্য সংক্রান্ত তথ্য পড়ুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.reproductive_health.write	গুগল ফিট প্ল্যাটফর্মে প্রজনন স্বাস্থ্য সংক্রান্ত তথ্য লিখুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.sleep.read	গুগল ফিট প্ল্যাটফর্ম থেকে ঘুমের ডেটা পড়ুন।	সীমাবদ্ধ
https://www.googleapis.com/auth/fitness.sleep.write	গুগল ফিট প্ল্যাটফর্মে ঘুমের তথ্য লিখুন।	সীমাবদ্ধ

বিদ্যমান অ্যাপে নতুন স্কোপ যোগ করা

যখন আপনি আপনার অ্যাপ আপডেট করে কোনো নতুন স্কোপের জন্য অনুরোধ করেন (উদাহরণস্বরূপ, যদি আপনি নতুন স্লিপ বা হার্ট রেট স্কোপ যোগ করেন, অথবা একটি রিড স্কোপ যোগ করেন), তখন ব্যবহারকারীদের জানানো হবে যে আপনার অ্যাপ এই স্কোপগুলোতে অ্যাক্সেসের জন্য অনুরোধ করছে এবং তারা সেই অ্যাক্সেস মঞ্জুর বা প্রত্যাখ্যান করতে পারবেন।

যখন আপনার রিসোর্সগুলির প্রয়োজন হয়, তখনই ব্যবহারকারীদের কাছ থেকে অনুমোদনের জন্য অনুরোধ করা সর্বোত্তম পন্থা। পর্যায়ক্রমিক অনুমোদনের অনুরোধ করার নির্দেশিকা অনুসরণ করুন।

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

• এমন একটি স্ক্রিন যোগ করার কথা বিবেচনা করুন যা ব্যবহারকারীদের সতর্ক করবে বা জানিয়ে দেবে যে তাদের কাছে এই স্কোপগুলো চাওয়া হবে।
• আপনার অ্যাপ কেন এই স্কোপ/ডেটাগুলিতে অ্যাক্সেস চাইছে তা স্পষ্টভাবে ব্যাখ্যা করুন, যাতে ব্যবহারকারীরা একটি সুচিন্তিত সিদ্ধান্ত নিতে পারেন।

অ্যান্ড্রয়েডের অ্যাপ পারমিশন সংক্রান্ত সেরা অনুশীলনগুলো সম্পর্কে আরও জানুন।