Users.dataSources: create

एक नया डेटा सोर्स बनाता है जो सभी डेटा सोर्स से यूनीक होता है इस उपयोगकर्ता को दिखेगा.

डेटा सोर्स, सेंसर डेटा का एक यूनीक सोर्स होता है. डेटा सोर्स, बिना अनुमति के सार्वजनिक हो सकते हैं ऐसा रॉ डेटा जो लोकल या साथी डिवाइसों पर हार्डवेयर सेंसर से मिलता है. वे दूसरे डेटा को कन्वर्ट या मर्ज करके बनाया गया डेटा भी सार्वजनिक कर सकता है स्रोत. एक ही तरह के डेटा के लिए कई डेटा सोर्स हो सकते हैं. हर डेटा फ़िटनेस एपीआई में डाले गए या उससे पढ़े गए हर डेटासेट के पॉइंट में लिंक किया गया है.

हर डेटा सोर्स, डेटासेट अपडेट की एक यूनीक स्ट्रीम बनाता है. इसमें यूनीक डेटा सोर्स आइडेंटिफ़ायर. डेटा सोर्स में किए गए सभी बदलाव, डेटा स्ट्रीम आईडी से कनेक्ट करता है, ताकि उस डेटा ऐप्लिकेशन/डिवाइस को अब भी उसी डेटा से जुड़ा माना जा सकता है स्रोत.

डेटा सोर्स की पहचान, सर्वर से जनरेट की गई स्ट्रिंग का इस्तेमाल करके की जाती है. इसके आधार पर कॉन्टेंट बनाने के लिए इस्तेमाल किया जा सकता है. 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 डेटा टाइप में हर फ़ील्ड के लिए इस्तेमाल किए जा सकने वाले अलग-अलग फ़ॉर्मैट.

ये वैल्यू स्वीकार की जाती हैं:
  • "blob"
  • "floatList"
  • "floatPoint"
  • "integer"
  • "integerList"
  • "map"
  • "string"
dataType.field[].name string डेटा का नाम और फ़ॉर्मैट तय करता है. डेटा टाइप के नामों से अलग, फ़ील्ड के नाम नेमस्पेस नहीं किए जाते और सिर्फ़ डेटा टाइप में उनका यूनीक होना ज़रूरी है.
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 या Android क्लाइंट पढ़ता है जिसने डेटा सोर्स नहीं बनाया है, तो उसे अस्पष्ट बना दिया जाता है. सिर्फ़ डेटा सोर्स बनाने वाले व्यक्ति को ही uid फ़ील्ड साफ़ और सामान्य रूप में दिखेगा.

अस्पष्ट बनाने की वजह से समानता बनी रहती है; इसका मतलब है कि दो आईडी दिए गए हैं, अगर id1 == id2, obfuscated(id1) == obfuscated(id2).

device.version string डिवाइस के हार्डवेयर/सॉफ़्टवेयर के लिए वर्शन स्ट्रिंग.
type string इस डेटा सोर्स के टाइप के बारे में बताने वाला कॉन्सटेंट. इससे पता चलता है कि यह डेटा सोर्स, रॉ डेटा देता है या डिराइव्ड डेटा.

ये वैल्यू स्वीकार की जाती हैं:
  • "derived"
  • "raw"

जवाब

कामयाब होने पर, यह तरीका रिस्पॉन्स के मुख्य हिस्से में Users.dataSources संसाधन दिखाता है.

इसे आज़माएं!

लाइव डेटा पर इस तरीके को कॉल करने और जवाब देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.