एक नया डेटा सोर्स बनाता है जो सभी डेटा सोर्स से यूनीक होता है
इस उपयोगकर्ता को दिखेगा.
डेटा सोर्स, सेंसर डेटा का एक यूनीक सोर्स होता है. डेटा सोर्स, बिना अनुमति के सार्वजनिक हो सकते हैं
ऐसा रॉ डेटा जो लोकल या साथी डिवाइसों पर हार्डवेयर सेंसर से मिलता है. वे
दूसरे डेटा को कन्वर्ट या मर्ज करके बनाया गया डेटा भी सार्वजनिक कर सकता है
स्रोत. एक ही तरह के डेटा के लिए कई डेटा सोर्स हो सकते हैं. हर डेटा
फ़िटनेस एपीआई में डाले गए या उससे पढ़े गए हर डेटासेट के पॉइंट में
लिंक किया गया है.
हर डेटा सोर्स, डेटासेट अपडेट की एक यूनीक स्ट्रीम बनाता है. इसमें
यूनीक डेटा सोर्स आइडेंटिफ़ायर. डेटा सोर्स में किए गए सभी बदलाव,
डेटा स्ट्रीम आईडी से कनेक्ट करता है, ताकि उस डेटा
ऐप्लिकेशन/डिवाइस को अब भी उसी डेटा से जुड़ा माना जा सकता है
स्रोत.
डेटा सोर्स की पहचान, सर्वर से जनरेट की गई स्ट्रिंग का इस्तेमाल करके की जाती है. इसके आधार पर
कॉन्टेंट बनाने के लिए इस्तेमाल किया जा सकता है. dataStreamId
इस तरीके का इस्तेमाल करते समय, फ़ील्ड में सेट नहीं होना चाहिए. यह
सर्वर सही फ़ॉर्मैट में अपने-आप जनरेट करेगा. अगर आपने
dataStreamId
सेट है, तो यह उस फ़ॉर्मैट से मेल खाना चाहिए जो
सर्वर जनरेट करेगा. यह फ़ॉर्मैट
होता है और उसका एक तय क्रम होता है. अगर यह मेल नहीं खाता है, तो अनुरोध
गड़बड़ी के साथ फ़ेल हो जाएगा.
एक ऐसा DataType तय करना जिसके बारे में जानकारी नहीं है (इससे शुरू होता है
"com.google.") कस्टम डेटा टाइप के साथ एक DataSource बनाएगा.
कस्टम डेटा टाइप को सिर्फ़ उस ऐप्लिकेशन से पढ़ा जा सकता है जिसकी मदद से उन्हें बनाया गया है.
कस्टम डेटा टाइप अब काम नहीं करते; स्टैंडर्ड डेटा टाइप का इस्तेमाल करते हैं
आज़माएं.
डेटा सोर्स आईडी में शामिल डेटा सोर्स फ़ील्ड के अलावा,
डेवलपर प्रोजेक्ट नंबर, जिसकी पुष्टि डेटा बनाते समय की गई हो
स्रोत शामिल है. पढ़ने पर, यह डेवलपर प्रोजेक्ट नंबर उलझा हुआ है
सार्वजनिक डेटा टाइप को पढ़ने वाले किसी भी दूसरे डेवलपर के ज़रिए.
इसे अभी आज़माएं.
अनुरोध
एचटीटीपी अनुरोध
POST https://www.googleapis.com/fitness/v1/users/userId/dataSources
पैरामीटर
पैरामीटर का नाम | मान | ब्यौरा |
---|---|---|
पाथ पैरामीटर | ||
userId |
string |
पहचाने गए व्यक्ति के लिए डेटा सोर्स बनाएं. इसके लिए me का इस्तेमाल करें
प्रमाणित उपयोगकर्ता को दर्शाता हो. इसमें सिर्फ़ me का इस्तेमाल किया जा सकता है
समय.
|
अनुमति देना
इस अनुरोध के लिए, इनमें से कम से कम एक दायरे की अनुमति लेना ज़रूरी है:
दायरा |
---|
https://www.googleapis.com/auth/fitness.activity.write |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
ज़्यादा जानकारी के लिए, पुष्टि करने और अनुमति देने से जुड़ा पेज देखें.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, यहां दी गई प्रॉपर्टी के साथ Users.dataSources संसाधन शामिल करें:
प्रॉपर्टी का नाम | मान | ब्यौरा | नोट |
---|---|---|---|
ज़रूरी प्रॉपर्टी | |||
application |
nested object |
ऐसे ऐप्लिकेशन के बारे में जानकारी जो प्लैटफ़ॉर्म में सेंसर डेटा फ़ीड करता है. | |
application.name |
string |
इस ऐप्लिकेशन का नाम. REST क्लाइंट के लिए यह ज़रूरी है, लेकिन हम इस नाम की खासियत को लागू नहीं करते. यह सुविधा उन दूसरे डेवलपर के लिए है जो यह जानना चाहते हैं कि किस REST ने ऐप्लिकेशन या डेटा सोर्स बनाया है. | |
dataType |
nested object |
डेटा टाइप, फ़िटनेस एपीआई की मदद से इकट्ठा किए जा रहे, उसमें डाले गए या उसके बारे में क्वेरी किए जाने वाले डेटा की स्ट्रीम के लिए स्कीमा तय करता है. | |
dataType.field[] |
list |
फ़ील्ड, डेटा टाइप का एक डाइमेंशन दिखाता है. | |
dataType.field[].format |
string |
डेटा टाइप में हर फ़ील्ड के लिए इस्तेमाल किए जा सकने वाले अलग-अलग फ़ॉर्मैट.
ये वैल्यू स्वीकार की जाती हैं:
|
|
dataType.field[].name |
string |
डेटा का नाम और फ़ॉर्मैट तय करता है. डेटा टाइप के नामों से अलग, फ़ील्ड के नाम नेमस्पेस नहीं किए जाते और सिर्फ़ डेटा टाइप में उनका यूनीक होना ज़रूरी है. | |
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 |
डिवाइस के हार्डवेयर/सॉफ़्टवेयर के लिए वर्शन स्ट्रिंग. | |
type |
string |
इस डेटा सोर्स के टाइप के बारे में बताने वाला कॉन्सटेंट. इससे पता चलता है कि यह डेटा सोर्स, रॉ डेटा देता है या डिराइव्ड डेटा.
ये वैल्यू स्वीकार की जाती हैं:
|
जवाब
कामयाब होने पर, यह तरीका रिस्पॉन्स के मुख्य हिस्से में Users.dataSources संसाधन दिखाता है.
इसे आज़माएं!
लाइव डेटा पर इस तरीके को कॉल करने और जवाब देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.