Users.dataSources: update

बताए गए डेटा स्रोत को अपडेट करता है. version के अपवाद के साथ, dataStreamId, dataType, type, dataStreamName, और device प्रॉपर्टी में बदलाव नहीं किया जा सकता.

डेटा सोर्स की पहचान उनके dataStreamId से की जाती है. इसे अभी आज़माएं.

अनुरोध करें

एचटीटीपी अनुरोध

PUT https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId

पैरामीटर

पैरामीटर का नाम वैल्यू जानकारी
पाथ पैरामीटर
dataSourceId string अपडेट किए जाने वाले डेटा सोर्स का डेटा स्ट्रीम आईडी.
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 से ऐप्लिकेशन या डेटा सोर्स बना है.
dataStreamId string इस डेटा सोर्स से जनरेट होने वाली डेटा स्ट्रीम के लिए एक यूनीक आइडेंटिफ़ायर. इस आइडेंटिफ़ायर में ये चीज़ें शामिल हैं:

  • डिवाइस और मैन्युफ़ैक्चरर का मॉडल, सीरियल नंबर, और सीरियल नंबर (UID).
  • ऐप्लिकेशन के पैकेज का नाम या नाम. पैकेज नाम का इस्तेमाल तब किया जाता है, जब डेटा स्रोत Android ऐप्लिकेशन से बनाया गया हो. डेवलपर प्रोजेक्ट नंबर का इस्तेमाल तब किया जाता है, जब डेटा स्रोत किसी REST क्लाइंट ने बनाया हो.
  • डेटा सोर्स किस तरह का है.
  • डेटा सोर्स की स्ट्रीम का नाम.
ध्यान दें कि स्ट्रीम आइडेंटिफ़ायर के हिस्से के तौर पर, डेटा सोर्स के सभी एट्रिब्यूट का इस्तेमाल नहीं किया जाता. खास तौर पर, हार्डवेयर के वर्शन/ऐप्लिकेशन का इस्तेमाल नहीं होता है. इससे हम वर्शन अपडेट के ज़रिए वही स्ट्रीम सुरक्षित रख सकते हैं. इसका मतलब यह भी है कि दो DataSource ऑब्जेक्ट एक ही डेटा स्ट्रीम को दिखा सकते हैं, भले ही वे एक बराबर न हों.

Android ऐप्लिकेशन से बनाए गए डेटा स्ट्रीम आईडी का सटीक फ़ॉर्मैट है: 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:डेवलपर प्रोजेक्ट नंबर

आखिर में, डेवलपर प्रोजेक्ट नंबर और डिवाइस के यूआईडी को अस्पष्ट कर दिया जाता है, ताकि डेटा स्रोत को न बनाने वाले किसी भी REST या Android क्लाइंट को पढ़ा जा सके. सिर्फ़ डेटा सोर्स बनाने वाले को, डेवलपर प्रोजेक्ट नंबर साफ़ और सामान्य फ़ॉर्म में दिखेगा. इसका मतलब है कि क्लाइंट को अलग-अलग क्रेडेंशियल वाले किसी दूसरे क्लाइंट की तुलना में data_stream_ids का अलग सेट दिखेगा.

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 क्लाइंट के पढ़ने पर इस फ़ील्ड को अस्पष्ट कर दिया जाता है. यूआईडी फ़ील्ड को सिर्फ़ डेटा सोर्स क्रिएटर को साफ़ और सामान्य फ़ॉर्म में दिखेगा.

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

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

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "derived"
  • "raw"

जवाब

अगर यह तरीका लागू होता है, तो जवाब के तरीके में Users.dataSources संसाधन को दिखाया जाता है.

इसे आज़माएं!

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