Users.dataSources

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

হার্ডওয়্যার ডিভাইস এবং ডেটা সংগ্রহ করা এবং/অথবা রূপান্তরিত করা অ্যাপ্লিকেশন সহ ডেটা উৎসে তার ডেটা অনন্যভাবে সনাক্ত করার জন্য যথেষ্ট তথ্য রয়েছে। এটি হার্ডওয়্যার এবং অ্যাপ্লিকেশন সংস্করণ এবং ডিভাইসের প্রকারের মতো দরকারী মেটাডেটাও ধারণ করে৷

প্রতিটি ডেটা উত্স একটি অনন্য শনাক্তকারী সহ ডেটার একটি অনন্য প্রবাহ তৈরি করে। ডেটা উত্সের সমস্ত পরিবর্তন স্ট্রিম শনাক্তকারীকে প্রভাবিত করে না, যাতে একই অ্যাপ্লিকেশন/ডিভাইসের আপডেট হওয়া সংস্করণগুলি দ্বারা সংগৃহীত ডেটা এখনও একই ডেটা স্ট্রিমের অন্তর্গত বলে বিবেচনা করা যেতে পারে।

এই সম্পদের জন্য পদ্ধতির তালিকার জন্য, এই পৃষ্ঠার শেষে দেখুন।

সম্পদ উপস্থাপনা

{
  "dataStreamId": string,
  "name": string,
  "dataStreamName": string,
  "type": string,
  "dataType": {
    "name": string,
    "field": [
      {
        "name": string,
        "format": string,
        "optional": boolean
      }
    ]
  },
  "device": {
    "uid": string,
    "type": string,
    "version": string,
    "model": string,
    "manufacturer": string
  },
  "application": {
    "packageName": string,
    "version": string,
    "detailsUrl": string,
    "name": string
  },
  "dataQualityStandard": [
    string
  ]
}
সম্পত্তির নাম মান বর্ণনা মন্তব্য
application nested object একটি অ্যাপ্লিকেশন সম্পর্কে তথ্য যা প্ল্যাটফর্মে সেন্সর ডেটা ফিড করে।
application. detailsUrl string একটি ঐচ্ছিক ইউআরআই যা অ্যাপ্লিকেশনে আবার লিঙ্ক করতে ব্যবহার করা যেতে পারে।
application. name string এই অ্যাপ্লিকেশনটির নাম। এটি REST ক্লায়েন্টদের জন্য প্রয়োজনীয়, কিন্তু আমরা এই নামের স্বতন্ত্রতা প্রয়োগ করি না। এটি অন্যান্য ডেভেলপারদের জন্য সুবিধার বিষয় হিসাবে প্রদান করা হয়েছে যারা সনাক্ত করতে চান কোন REST একটি অ্যাপ্লিকেশন বা ডেটা উত্স তৈরি করেছে৷
application. packageName string এই অ্যাপ্লিকেশনের জন্য প্যাকেজ নাম. এটি একটি অনন্য শনাক্তকারী হিসাবে ব্যবহৃত হয় যখন Android অ্যাপ্লিকেশনগুলি তৈরি করে, কিন্তু REST ক্লায়েন্টদের দ্বারা নির্দিষ্ট করা যায় না৷ REST ক্লায়েন্টদের তাদের ডেভেলপার প্রজেক্ট নম্বর প্যাকেজ নামের পরিবর্তে ডেটা সোর্স ডেটা স্ট্রিম আইডিতে প্রতিফলিত হবে।
application. version string অ্যাপ্লিকেশনটির সংস্করণ। আপনার এই ক্ষেত্রটি আপডেট করা উচিত যখনই অ্যাপ্লিকেশনটি এমনভাবে পরিবর্তিত হয় যা ডেটা গণনাকে প্রভাবিত করে।
dataQualityStandard[] list এই ক্ষেত্রটি জনবহুল করবেন না। প্ল্যাটফর্মের প্রতিক্রিয়াগুলিতে এটি কখনই জনবহুল হয় না এবং প্রশ্নগুলিতে উপেক্ষা করা হয়। এটি ভবিষ্যতের সংস্করণে সম্পূর্ণরূপে সরানো হবে।
dataStreamId string এই ডেটা উত্স দ্বারা উত্পাদিত ডেটা স্ট্রিমের জন্য একটি অনন্য শনাক্তকারী৷ শনাক্তকারীর মধ্যে রয়েছে:

  • প্রকৃত ডিভাইসের প্রস্তুতকারক, মডেল এবং সিরিয়াল নম্বর (UID)।
  • অ্যাপ্লিকেশনটির প্যাকেজের নাম বা নাম। প্যাকেজ নামটি ব্যবহার করা হয় যখন একটি Android অ্যাপ্লিকেশন দ্বারা ডেটা উৎস তৈরি করা হয়। ডেভেলপার প্রজেক্ট নম্বর ব্যবহার করা হয় যখন ডেটা উৎসটি একটি REST ক্লায়েন্ট তৈরি করে।
  • ডেটা উৎসের ধরন।
  • ডেটা উৎসের স্ট্রিম নাম।
মনে রাখবেন যে ডেটা উত্সের সমস্ত বৈশিষ্ট্য স্ট্রিম শনাক্তকারীর অংশ হিসাবে ব্যবহৃত হয় না। বিশেষ করে, হার্ডওয়্যার/অ্যাপ্লিকেশনের সংস্করণ ব্যবহার করা হয় না। এটি আমাদের সংস্করণ আপডেটের মাধ্যমে একই স্ট্রীম সংরক্ষণ করার অনুমতি দেয়। এর মানে হল যে দুটি ডেটাসোর্স অবজেক্ট সমান না হলেও একই ডেটা স্ট্রীম উপস্থাপন করতে পারে।

একটি Android অ্যাপ্লিকেশন দ্বারা তৈরি ডেটা স্ট্রিম আইডির সঠিক বিন্যাস হল: type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName

একটি REST ক্লায়েন্ট দ্বারা তৈরি ডেটা স্ট্রিম আইডির সঠিক বিন্যাস হল: type:dataType.name :developer project number :device.manufacturer :device.model:device.uid :dataStreamName type:dataType.name :developer project number :device.manufacturer :device.model:device.uid :dataStreamName type:dataType.name :developer project number :device.manufacturer :device.model:device.uid :dataStreamName type:dataType.name :developer project number :device.manufacturer :device.model:device.uid :dataStreamName type:dataType.name :developer project number :device.manufacturer :device.model:device.uid :dataStreamName

ডেটা স্ট্রিম আইডি তৈরি করে এমন কোনো ঐচ্ছিক ক্ষেত্র অনুপস্থিত থাকলে, সেগুলি ডেটা স্ট্রিম আইডি থেকে বাদ দেওয়া হবে। ন্যূনতম কার্যকর ডেটা স্ট্রিম আইডি হবে: type:dataType.name:বিকাশকারী প্রকল্প নম্বর

অবশেষে, ডেভেলপারের প্রজেক্ট নম্বর এবং ডিভাইস UID যখন ডেটা উৎস তৈরি করেনি এমন কোনও REST বা Android ক্লায়েন্ট দ্বারা পড়ার সময় অস্পষ্ট হয়ে যায়। শুধুমাত্র ডেটা সোর্স স্রষ্টাই ডেভেলপার প্রজেক্ট নম্বরটি পরিষ্কার এবং স্বাভাবিক আকারে দেখতে পাবেন। এর মানে হল একটি ক্লায়েন্ট বিভিন্ন শংসাপত্র সহ অন্য ক্লায়েন্টের চেয়ে data_stream_ids এর একটি ভিন্ন সেট দেখতে পাবে।

dataStreamName string স্ট্রিম নামটি একই অন্তর্নিহিত প্রযোজকের কাছ থেকে একই ধরণের অন্যান্য ডেটা উত্সগুলির মধ্যে এই নির্দিষ্ট ডেটা উত্সটিকে অনন্যভাবে সনাক্ত করে। স্ট্রীমের নাম সেট করা ঐচ্ছিক, কিন্তু যখনই একটি অ্যাপ্লিকেশন একই ডেটা টাইপের জন্য দুটি স্ট্রীম প্রকাশ করে বা যখন একটি ডিভাইসে দুটি সমতুল্য সেন্সর থাকে তখন এটি করা উচিত৷
dataType nested object ডেটা টাইপ ফিটনেস API দ্বারা সংগৃহীত, সন্নিবেশিত বা অনুসন্ধান করা ডেটার একটি স্ট্রিমের স্কিমাকে সংজ্ঞায়িত করে৷
dataType. field[] list একটি ক্ষেত্র একটি ডেটা টাইপের একটি মাত্রা উপস্থাপন করে।
dataType.field[]. format string ডেটা টাইপের প্রতিটি ক্ষেত্রের জন্য বিভিন্ন সমর্থিত বিন্যাস।

গ্রহণযোগ্য মান হল:
  • " blob "
  • " floatList "
  • " floatPoint "
  • " integer "
  • " integerList "
  • " map "
  • " string "
dataType.field[]. name string ডেটার নাম এবং বিন্যাস সংজ্ঞায়িত করে। ডেটা টাইপের নামের বিপরীতে, ক্ষেত্রের নামগুলি নামস্থানে থাকে না এবং শুধুমাত্র ডেটা টাইপের মধ্যে অনন্য হতে হবে।
dataType.field[]. optional boolean
dataType. name string প্রতিটি ডেটা টাইপের একটি অনন্য, নামস্থান, নাম রয়েছে। com.google নামস্থানে সমস্ত ডেটা প্রকারগুলি প্ল্যাটফর্মের অংশ হিসাবে ভাগ করা হয়৷
device nested object একটি সমন্বিত ডিভাইসের প্রতিনিধিত্ব (যেমন একটি ফোন বা পরিধানযোগ্য) যা সেন্সর ধরে রাখতে পারে।
device. manufacturer string পণ্য/হার্ডওয়্যারের প্রস্তুতকারক।
device. model string ডিভাইসটির জন্য শেষ-ব্যবহারকারীর দৃশ্যমান মডেলের নাম।
device. type string একটি ধ্রুবক ডিভাইসের প্রকারের প্রতিনিধিত্ব করে।

গ্রহণযোগ্য মান হল:
  • " chestStrap "
  • " headMounted "
  • " phone "
  • " scale "
  • " smartDisplay "
  • " tablet "
  • " unknown "
  • " watch "
device. uid string হার্ডওয়্যারের জন্য সিরিয়াল নম্বর বা অন্যান্য অনন্য আইডি। ডেটা উৎস তৈরি করেনি এমন কোনও REST বা অ্যান্ড্রয়েড ক্লায়েন্ট পড়ার সময় এই ক্ষেত্রটি অস্পষ্ট হয়ে যায়। শুধুমাত্র ডাটা সোর্স স্রষ্টাই uid ফিল্ডটি পরিষ্কার এবং স্বাভাবিক আকারে দেখতে পাবেন।

অস্পষ্টতা সমতা রক্ষা করে; অর্থাৎ, দুটি আইডি দেওয়া, যদি id1 == id2, অস্পষ্ট(id1) == অস্পষ্ট(id2)।

device. version string ডিভাইস হার্ডওয়্যার/সফ্টওয়্যারের জন্য সংস্করণ স্ট্রিং।
name string এই ডেটা উৎসের জন্য একটি শেষ-ব্যবহারকারীর দৃশ্যমান নাম।
type string একটি ধ্রুবক এই ডেটা উৎসের ধরন বর্ণনা করে। এই ডেটা উত্সটি কাঁচা বা প্রাপ্ত ডেটা তৈরি করে কিনা তা নির্দেশ করে৷

গ্রহণযোগ্য মান হল:
  • " derived "
  • " raw "

পদ্ধতি

সৃষ্টি
একটি নতুন ডেটা উত্স তৈরি করে যা এই ব্যবহারকারীর সমস্ত ডেটা উত্স জুড়ে অনন্য৷

একটি ডেটা উৎস হল সেন্সর ডেটার একটি অনন্য উৎস। ডেটা উত্সগুলি স্থানীয় বা সহচর ডিভাইসগুলিতে হার্ডওয়্যার সেন্সর থেকে আসা কাঁচা ডেটা প্রকাশ করতে পারে৷ তারা প্রাপ্ত ডেটাও প্রকাশ করতে পারে, যা অন্যান্য ডেটা উত্স রূপান্তরিত বা একত্রিত করে তৈরি করা হয়েছে। একই ডেটা টাইপের জন্য একাধিক ডেটা উৎস থাকতে পারে। Fitness API-এ ঢোকানো বা পড়া প্রতিটি ডেটাসেটের প্রতিটি ডেটা পয়েন্টের একটি সংশ্লিষ্ট ডেটা উৎস রয়েছে।

প্রতিটি ডেটা উৎস একটি অনন্য ডেটা উৎস শনাক্তকারী সহ ডেটাসেট আপডেটের একটি অনন্য স্ট্রীম তৈরি করে। ডেটা উত্সের সমস্ত পরিবর্তন ডেটা স্ট্রিম আইডিকে প্রভাবিত করে না, যাতে একই অ্যাপ্লিকেশন/ডিভাইসের আপডেট হওয়া সংস্করণগুলি দ্বারা সংগৃহীত ডেটা এখনও একই ডেটা উত্সের অন্তর্গত বলে বিবেচিত হতে পারে৷

সার্ভার দ্বারা উত্পন্ন একটি স্ট্রিং ব্যবহার করে ডেটা উত্স সনাক্ত করা হয়, উৎসের বিষয়বস্তুর উপর ভিত্তি করে তৈরি করা হচ্ছে। এই পদ্ধতি চালু করার সময় dataStreamId ক্ষেত্র সেট করা উচিত নয়। এটি সঠিক বিন্যাস সহ সার্ভার দ্বারা স্বয়ংক্রিয়ভাবে তৈরি হবে। একটি dataStreamId সেট করা থাকলে, সার্ভার যে বিন্যাস তৈরি করবে তার সাথে এটি অবশ্যই মিলবে। এই বিন্যাসটি ডেটা উত্স থেকে কিছু ক্ষেত্রের সংমিশ্রণ, এবং একটি নির্দিষ্ট ক্রম রয়েছে। যদি এটি মেলে না, অনুরোধটি একটি ত্রুটি সহ ব্যর্থ হবে৷

একটি ডেটা টাইপ নির্দিষ্ট করা যা একটি পরিচিত প্রকার নয় ("com.google" দিয়ে শুরু) একটি কাস্টম ডেটা টাইপ সহ একটি ডেটাসোর্স তৈরি করবে৷ কাস্টম ডেটা টাইপগুলি যে অ্যাপ্লিকেশনটি তৈরি করেছে তা শুধুমাত্র পঠনযোগ্য। কাস্টম ডেটা প্রকারগুলি অবহেলিত ; পরিবর্তে স্ট্যান্ডার্ড ডেটা টাইপ ব্যবহার করুন।

ডেটা উত্স আইডিতে অন্তর্ভুক্ত ডেটা উত্স ক্ষেত্রগুলি ছাড়াও, ডেটা উত্স তৈরি করার সময় প্রমাণীকৃত বিকাশকারী প্রকল্প নম্বর অন্তর্ভুক্ত করা হয়েছে৷ এই ডেভেলপার প্রজেক্ট নম্বর অস্পষ্ট হয় যখন অন্য কোন ডেভেলপার পাবলিক ডাটা টাইপ পড়ে।
মুছে ফেলা
নির্দিষ্ট ডেটা উৎস মুছে দেয়। ডেটা উৎসে কোনো ডেটা পয়েন্ট থাকলে অনুরোধটি ব্যর্থ হবে।
পাওয়া
নির্দিষ্ট ডেটা উৎস প্রদান করে।
তালিকা
প্রদত্ত OAuth স্কোপগুলি ব্যবহার করে বিকাশকারীর কাছে দৃশ্যমান সমস্ত ডেটা উত্সের তালিকা করে৷ তালিকাটি সম্পূর্ণ নয়; ব্যবহারকারীর ব্যক্তিগত ডেটা উত্স থাকতে পারে যা শুধুমাত্র অন্যান্য বিকাশকারীদের কাছে দৃশ্যমান, বা অন্য স্কোপ ব্যবহার করে কল করতে পারে৷
হালনাগাদ
নির্দিষ্ট ডেটা উৎস আপডেট করে। version ব্যতীত dataStreamId , dataType , type , dataStreamName , এবং device বৈশিষ্ট্যগুলিকে সংশোধন করা যাবে না৷

ডেটা উত্সগুলিকে তাদের dataStreamId দ্বারা চিহ্নিত করা হয়৷