एक नया डेटा सोर्स बनाता है जो इस उपयोगकर्ता से जुड़े
सभी डेटा सोर्स में यूनीक होता है.
डेटा सोर्स, सेंसर डेटा का एक यूनीक सोर्स होता है. डेटा सोर्स, स्थानीय या साथी डिवाइसों के हार्डवेयर सेंसर से मिलने वाले रॉ डेटा का पता लगा सकते हैं. वे
डेटा के अन्य स्रोतों को बदलकर या मर्ज करके हासिल किया गया डेटा भी दिखा सकते हैं. एक ही तरह के डेटा के लिए कई डेटा सोर्स मौजूद हो सकते हैं. फ़िटनेस एपीआई में शामिल या उससे पढ़े गए हर डेटासेट में, हर डेटा पॉइंट का एक डेटा स्रोत होता है.
हर डेटा सोर्स, डेटासेट के अपडेट की एक यूनीक स्ट्रीम बनाता है और
डेटा सोर्स का एक यूनीक आइडेंटिफ़ायर होता है. डेटा सोर्स में किए गए सभी बदलाव,
डेटा स्ट्रीम आईडी पर असर नहीं डालते हैं. इसलिए, एक ही ऐप्लिकेशन/डिवाइस
के अपडेट किए गए वर्शन से इकट्ठा किए गए डेटा को अब भी उसी डेटा सोर्स
से जुड़ा माना जा सकता है.
डेटा सोर्स की पहचान, सर्वर के ज़रिए जनरेट की गई स्ट्रिंग का इस्तेमाल करके की जाती है. यह स्ट्रिंग, बनाए जा रहे सोर्स के कॉन्टेंट के आधार पर तय की जाती है. इस तरीके को शुरू करते समय, dataStreamId
फ़ील्ड सेट नहीं किया जाना चाहिए. यह सर्वर से सही फ़ॉर्मैट में अपने-आप जनरेट होगा. अगर dataStreamId
सेट किया गया है, तो यह उस फ़ॉर्मैट से मेल खाना चाहिए जो सर्वर जनरेट करेगा. यह फ़ॉर्मैट, डेटा सोर्स के कुछ फ़ील्ड का कॉम्बिनेशन होता है और इसमें एक खास ऑर्डर होता है. अगर यह मेल नहीं खाता, तो
अनुरोध पूरा नहीं होगा.
ऐसा डेटा टाइप तय करने से जो जानी-पहचानी नहीं है ("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 क्लाइंट के पढ़ने पर इस फ़ील्ड को अस्पष्ट कर दिया जाता है. यूआईडी फ़ील्ड को सिर्फ़ डेटा सोर्स क्रिएटर को साफ़ और सामान्य फ़ॉर्म में दिखेगा. अस्पष्ट बनाने के तरीके से इक्वेशन को सुरक्षित रखा जाता है. इसका मतलब है कि अगर आईडी1 == id2, उलझाने वाला(id1) == उलझाने वाला(id2) है, तो दो आईडी दिए जाते हैं. |
|
device.version |
string |
डिवाइस के हार्डवेयर/सॉफ़्टवेयर के लिए वर्शन स्ट्रिंग. | |
type |
string |
इस डेटा सोर्स के टाइप की जानकारी देने वाला एक कॉन्सटेंट. इससे पता चलता है कि यह डेटा सोर्स, रॉ डेटा या उससे बना डेटा जनरेट करता है या नहीं.
इन वैल्यू का इस्तेमाल किया जा सकता है:
|
जवाब
अगर यह तरीका लागू होता है, तो जवाब के तरीके में Users.dataSources संसाधन को दिखाया जाता है.
इसे आज़माएं!
इस तरीके को लाइव डेटा पर कॉल करने और जवाब देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.