তথ্যের ধরণ

Google Fit com.google নামস্থানের অধীনে স্বাস্থ্য এবং সুস্থতার ডেটা প্রকারের একটি সেট সরবরাহ করে৷

ডেটা টাইপগুলি ডেটা পয়েন্টের ভিতরে মানগুলির বিন্যাসকে সংজ্ঞায়িত করে। একটি ডেটা পয়েন্ট প্রতিনিধিত্ব করতে পারে:

  • একটি তাত্ক্ষণিক পড়া বা পর্যবেক্ষণ
  • একটি সময়ের ব্যবধানে পরিসংখ্যান সহ একটি সমষ্টি৷

Google Fit তাত্ক্ষণিক পর্যবেক্ষণের জন্য ডেটা প্রকার এবং সামগ্রিক ডেটার জন্য ডেটা প্রকারগুলি সংজ্ঞায়িত করে৷ ডেটা পয়েন্টগুলি ডেটা টাইপ এবং টাইমস্ট্যাম্প তথ্যের ক্ষেত্রের মান নিয়ে গঠিত। যে পয়েন্টগুলি তাত্ক্ষণিক পর্যবেক্ষণের প্রতিনিধিত্ব করে সেগুলির মধ্যে একটি টাইমস্ট্যাম্প অন্তর্ভুক্ত থাকে এবং একটি সমষ্টিগত ডেটা টাইপের পয়েন্টগুলিও ব্যবধানের জন্য শুরুর সময় অন্তর্ভুক্ত করে।

Google Fit আপনাকে নতুন ডেটা প্রকারগুলি সংজ্ঞায়িত করতে দেয়৷

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

Google ফিটের এই ধরনের ডেটা রয়েছে:

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

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

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

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

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

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

  • ডেটা রেকর্ড করতে, আপনি রেকর্ড করতে চান এমন প্রতিটি ডেটা টাইপের জন্য একটি সাবস্ক্রিপশন তৈরি করতে রেকর্ডিং API ব্যবহার করুন।
  • ডেটা পড়তে, প্রতিটি ডেটা প্রকারের জন্য একটি পড়ার অনুরোধ জমা দিতে ইতিহাস API ব্যবহার করুন।
  • অতীতের ঐতিহাসিক ডেটা সন্নিবেশ করতে, প্রতিটি ডেটা প্রকারের জন্য একটি সন্নিবেশ অনুরোধ জমা দিতে ইতিহাস API ব্যবহার করুন।
  • সেশন তৈরি করতে, সেশন মেটাডেটা সহ ডেটা সন্নিবেশ বা রেকর্ড করতে সেশন 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()

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

বিশ্রাম

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

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

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

অনুমোদনের সুযোগ

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

OAuth স্কোপের সম্মতি স্ক্রীনের উদাহরণ
চিত্র 2. OAuth স্কোপ সম্মতি স্ক্রীন।

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

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

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

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

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

একটি বিদ্যমান অ্যাপে নতুন সুযোগ যোগ করা হচ্ছে

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

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

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

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

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