सेंसर डेटा के यूनीक सोर्स की परिभाषा. डेटा सोर्स, लोकल या साथी डिवाइसों पर हार्डवेयर सेंसर से आने वाला रॉ डेटा दिखा सकते हैं. वे दूसरे डेटा सोर्स का फ़ॉर्मैट बदलकर या मर्ज करके बनाए गए डेटा को भी दिखा सकते हैं. एक ही तरह के डेटा के लिए, कई डेटा सोर्स मौजूद हो सकते हैं. इस सेवा में डाले गए या उससे पढ़े गए हर डेटा पॉइंट में एक डेटा सोर्स जुड़ा होता है.
डेटा सोर्स में मौजूद डेटा की पहचान करने के लिए, ज़रूरी जानकारी मौजूद है. इसमें, डेटा इकट्ठा करने और/या उसमें बदलाव करने वाला हार्डवेयर डिवाइस और ऐप्लिकेशन भी शामिल है. इसमें हार्डवेयर और ऐप्लिकेशन वर्शन जैसे काम का मेटाडेटा भी होता है. साथ ही, इसमें डिवाइस टाइप भी होता है.
हर डेटा सोर्स, यूनीक आइडेंटिफ़ायर के साथ डेटा की एक यूनीक स्ट्रीम बनाता है. डेटा सोर्स में किए गए सभी बदलाव, स्ट्रीम आइडेंटिफ़ायर पर असर नहीं डालते. इसलिए, एक ही ऐप्लिकेशन/डिवाइस के अपडेट किए गए वर्शन से इकट्ठा किए गए डेटा को अब भी उसी डेटा स्ट्रीम से जुड़ा माना जा सकता है.
इस संसाधन के तरीकों की सूची के लिए, इस पेज का अंत देखें.
रिसॉर्स प्रतिनिधित्व
{ "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 क्लाइंट का डेवलपर प्रोजेक्ट नंबर, PackageName के बजाय डेटा सोर्स के डेटा स्ट्रीम आईडी में दिखेगा. | |
application.version |
string |
ऐप्लिकेशन का वर्शन. जब भी ऐप्लिकेशन में, डेटा के कैलकुलेशन पर असर पड़ता है, तो आपको यह फ़ील्ड अपडेट करना चाहिए. | |
dataQualityStandard[] |
list |
इस फ़ील्ड को पॉप्यूलेट न करें. इसे प्लैटफ़ॉर्म से मिलने वाले जवाबों में कभी भी शामिल नहीं किया जाता. साथ ही, इसे क्वेरी में अनदेखा कर दिया जाता है. आने वाले वर्शन में इस डेटा को पूरी तरह से हटा दिया जाएगा. | |
dataStreamId |
string |
इस डेटा सोर्स से बनाई गई डेटा स्ट्रीम के लिए, यूनीक आइडेंटिफ़ायर. आइडेंटिफ़ायर में ये चीज़ें शामिल होती हैं:
Android ऐप्लिकेशन से बनाए गए डेटा स्ट्रीम आईडी का सटीक फ़ॉर्मैट यह है: type:dataType.name REST क्लाइंट के बनाए गए डेटा स्ट्रीम आईडी का सटीक फ़ॉर्मैट यह है: type:dataType.name अगर डेटा स्ट्रीम आईडी बनाने वाले कोई भी वैकल्पिक फ़ील्ड मौजूद नहीं हैं, तो उन्हें डेटा स्ट्रीम आईडी से हटा दिया जाएगा. सबसे ज़रूरी डेटा स्ट्रीम आईडी यह होगा: type:dataType.name:developer प्रोजेक्ट नंबर आखिर में, किसी भी ऐसे REST या Android क्लाइंट से पढ़ते समय डेवलपर प्रोजेक्ट नंबर और डिवाइस का यूआईडी अस्पष्ट हो जाता है जिसने डेटा सोर्स नहीं बनाया है. डेवलपर प्रोजेक्ट नंबर, सिर्फ़ डेटा सोर्स बनाने वाले को साफ़ और सामान्य तरीके से दिखेगा. इसका मतलब है कि क्लाइंट को अलग-अलग क्रेडेंशियल वाले दूसरे क्लाइंट की तुलना में, data_stream_ids का अलग सेट दिखेगा. |
|
dataStreamName |
string |
स्ट्रीम का नाम, एक ही प्रोड्यूसर के उसी टाइप के दूसरे डेटा सोर्स के बीच, इस डेटा सोर्स की खास तौर पर पहचान करता है. स्ट्रीम का नाम सेट करना ज़रूरी नहीं है. हालांकि, ऐसा तब करना चाहिए, जब कोई ऐप्लिकेशन एक ही तरह के डेटा के लिए दो स्ट्रीम दिखाए या जब किसी डिवाइस में दो मिलते-जुलते सेंसर हों. | |
dataType |
nested object |
डेटा टाइप, Fitness API से इकट्ठा किए जा रहे, उसमें डाले गए या उससे क्वेरी किए जाने वाले डेटा की स्ट्रीम के स्कीमा को तय करता है. | |
dataType.field[] |
list |
फ़ील्ड, डेटा टाइप का एक डाइमेंशन दिखाता है. | |
dataType.field[].format |
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 |
डिवाइस के टाइप को दिखाने वाला कॉन्स्टेंट.
इन वैल्यू को इस्तेमाल किया जा सकता है:
|
|
device.uid |
string |
हार्डवेयर का सीरियल नंबर या अन्य यूनीक आईडी. जिस REST या Android क्लाइंट ने डेटा सोर्स नहीं बनाया है उसके ज़रिए पढ़े जाने पर, यह फ़ील्ड अस्पष्ट हो जाता है. uid फ़ील्ड, सिर्फ़ डेटा सोर्स बनाने वाले को साफ़ और सामान्य फ़ॉर्म में दिखेगा. अस्पष्ट बनाने से, बराबरी का मौका बना रहता है. इसका मतलब है कि अगर id1 == id2, obfuscated(id1) == obfuscated(id2) दो आईडी दी जाती हैं, तो यह बराबरी का होगा. |
|
device.version |
string |
डिवाइस हार्डवेयर/सॉफ़्टवेयर के लिए वर्शन स्ट्रिंग. | |
name |
string |
इस डेटा सोर्स के लिए, असली उपयोगकर्ता को दिखने वाला नाम. | |
type |
string |
इस डेटा सोर्स के टाइप की जानकारी देने वाला कॉन्सटेंट. इससे पता चलता है कि यह डेटा सोर्स, रॉ डेटा जनरेट करता है या हासिल किया गया डेटा.
इन वैल्यू को इस्तेमाल किया जा सकता है:
|
तरीके
- बनाएं
- एक ऐसा नया डेटा सोर्स बनाता है जो इस उपयोगकर्ता से जुड़े सभी
डेटा सोर्स से अलग हो.
डेटा सोर्स, सेंसर डेटा का यूनीक सोर्स होता है. डेटा सोर्स, लोकल या कंपैनियन डिवाइसों पर हार्डवेयर सेंसर से आने वाला रॉ डेटा दिखा सकते हैं. वे दूसरे डेटा सोर्स को बदलकर या मर्ज करके बनाए गए डेटा को भी दिखा सकते हैं. एक ही तरह के डेटा के लिए, कई डेटा सोर्स मौजूद हो सकते हैं. Fitness API में डाले गए या उससे पढ़े गए हर डेटासेट में मौजूद हर डेटा पॉइंट से एक डेटा सोर्स जुड़ा होता है.
हर डेटा सोर्स, एक यूनीक डेटा सोर्स आइडेंटिफ़ायर के साथ डेटासेट अपडेट की एक यूनीक स्ट्रीम बनाता है. डेटा सोर्स में किए जाने वाले सभी बदलाव, डेटा स्ट्रीम आईडी पर असर नहीं डालते. इस वजह से, एक ही ऐप्लिकेशन/डिवाइस के अपडेट किए गए वर्शन से इकट्ठा किए गए डेटा को अब भी एक ही डेटा सोर्स से जुड़ा माना जा सकता है.
डेटा सोर्स की पहचान, सर्वर से जनरेट की गई स्ट्रिंग का इस्तेमाल करके की जाती है. यह पहचान, बनाए जा रहे सोर्स के कॉन्टेंट के आधार पर की जाती है. इस तरीके को शुरू करते समय,dataStreamId
फ़ील्ड को सेट नहीं किया जाना चाहिए. यह सर्वर सही फ़ॉर्मैट के साथ अपने-आप जनरेट करेगा. अगरdataStreamId
सेट है, तो यह सर्वर से जनरेट होने वाले फ़ॉर्मैट से मैच होना चाहिए. यह फ़ॉर्मैट, डेटा सोर्स के कुछ फ़ील्ड का कॉम्बिनेशन होता है और इसका एक खास क्रम होता है. अगर यह मेल नहीं खाता है, तो अनुरोध एक गड़बड़ी के साथ विफल हो जाएगा.
अगर किसी ऐसे डेटा टाइप के बारे में बताना है जो आम तौर पर उपलब्ध नहीं है (जिस तरह का डेटा "com.google." से शुरू होता है), तो कस्टम डेटा टाइप वाला डेटा सोर्स बन जाएगा. कस्टम डेटा टाइप को सिर्फ़ उसी ऐप्लिकेशन से पढ़ा जा सकता है जिसने उन्हें बनाया है. कस्टम डेटा टाइप अब काम नहीं करते. इसके बजाय, स्टैंडर्ड डेटा टाइप का इस्तेमाल करें.
डेटा सोर्स आईडी में शामिल डेटा सोर्स फ़ील्ड के अलावा, डेटा सोर्स बनाते समय पुष्टि किया गया डेवलपर प्रोजेक्ट नंबर भी शामिल होता है. जब कोई अन्य डेवलपर, सार्वजनिक डेटा टाइप को पढ़ता है, तब यह डेवलपर प्रोजेक्ट नंबर छिपा दिया जाता है. - मिटाएं
- दिया गया डेटा सोर्स मिटा देता है. अगर डेटा सोर्स में कोई भी डेटा पॉइंट है, तो अनुरोध पूरा नहीं हो पाएगा.
- get
- दिया गया डेटा सोर्स दिखाता है.
- list
- इसमें दिए गए OAuth के दायरे का इस्तेमाल करके, डेवलपर को दिखने वाले सभी डेटा सोर्स की सूची बनाई जाती है. यह पूरी सूची नहीं है. उपयोगकर्ता के पास ऐसे निजी डेटा सोर्स हो सकते हैं जो सिर्फ़ अन्य डेवलपर को दिखते हैं या अन्य स्कोप का इस्तेमाल करके कॉल किए जा सकते हैं.
- अपडेट
- बताया गया डेटा स्रोत अपडेट करता है.
version
को छोड़कर,dataStreamId
,dataType
,type
,dataStreamName
, औरdevice
प्रॉपर्टी में बदलाव नहीं किया जा सकता.
डेटा सोर्स की पहचान उनकेdataStreamId
से की जाती है.