फ़िटनेस REST API आपको डेटा स्रोत बनाने, पाने, और अपडेट करने की सुविधा देता है. डेटा सोर्स, सेंसर डेटा का एक यूनीक सोर्स दिखाता है. आप फ़िटनेस स्टोर में फ़िटनेस डेटा डालने के लिए डेटा स्रोत इस्तेमाल करते हैं और आप किसी खास डेटा स्रोत के ज़रिए डाला गया फ़िटनेस डेटा वापस पा सकते हैं.
डेटा सोर्स, Users.dataSources
संसाधन दिखाते हैं.
डेटा स्रोत बनाना
इस उदाहरण में "MyDataSource" नाम का एक नया डेटा स्रोत बनाने का तरीका बताया गया है, जो चरणों की संख्या में बढ़ोतरी की सुविधा देता है.
- एचटीटीपी मेथड
- पोस्ट करें
- URL का अनुरोध करें
https://www.googleapis.com/fitness/v1/users/me/dataSources
- अनुरोध का मुख्य भाग
{ "dataStreamName": "MyDataSource", "type": "derived", "application": { "detailsUrl": "http://example.com", "name": "Foo Example App", "version": "1" }, "dataType": { "field": [ { "name": "steps", "format": "integer" } ], "name": "com.google.step_count.delta" }, "device": { "manufacturer": "Example Manufacturer", "model": "ExampleTablet", "type": "tablet", "uid": "1000001", "version": "1.0" } }
- जवाब
अगर डेटा सोर्स बन गया है, तो रिस्पॉन्स
200 OK
स्टेटस कोड होता है. जवाब के मुख्य भाग में डेटा स्रोत का JSON प्रतिनिधित्व शामिल होता है, इसमेंdatasource.dataStreamId
प्रॉपर्टी शामिल होती है, जिसका इस्तेमाल आप बाद के अनुरोधों के लिए डेटा स्रोत आईडी के तौर पर कर सकते हैं.- कर्ल निर्देश
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X POST \ --header "Content-Type: application/json;encoding=utf-8" -d @createds.json \ "https://www.googleapis.com/fitness/v1/users/me/dataSources"
कोई खास डेटा सोर्स पाना
इस उदाहरण में, पिछले उदाहरण में बनाए गए डेटा सोर्स ("MyDataSource") को वापस पाने का तरीका बताया गया है. कोई नया डेटा सोर्स बनाने पर,
dataStreamId
में एक यूनीक आइडेंटिफ़ायर ("1234567890" इन उदाहरणों में दिखाया गया) होता है. यह आपका डेवलपर प्रोजेक्ट नंबर है. साथ ही, यह उस खास डेवलपर खाते का इस्तेमाल करके किए गए
सभी अनुरोधों के लिए एक ही होगा. अपने बनाए गए डेटा सोर्स में से
dataStreamId
का इस्तेमाल करना न भूलें.
- एचटीटीपी मेथड
- पाएं
- URL का अनुरोध करें
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
- अनुरोध का मुख्य भाग
- कोई नहीं
- जवाब
- अगर डेटा सोर्स मौजूद है, तो रिस्पॉन्स
200 OK
स्टेटस कोड होगा. रिस्पॉन्स के मुख्य भाग में, डेटा सोर्स की JSON फ़ाइल होती है. - कर्ल निर्देश
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X GET
--header "Content-Type: application/json;encoding=utf-8"
"https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource"
एग्रीगेट किया गया डेटा पाना
इस उदाहरण में बताया गया है कि एग्रीगेट किए गए डेटा के लिए किसी खास डेटा सोर्स को क्वेरी कैसे की जाती है. यहां दिए गए estimated_steps
उदाहरण के लिए, Google Fit ऐप्लिकेशन में डेटा इकट्ठा करने का तरीका दिखाने के लिए डेटा सोर्स का इस्तेमाल किया जाता है. ध्यान दें कि JSON अनुरोध में दिए गए टाइमस्टैंप, मिलीसेकंड में होते हैं.
- एचटीटीपी मेथड
- पोस्ट करें
- URL का अनुरोध करें
https://www.googleapis.com/fitness/v1/users/me/dataset:aggregate
- अनुरोध का मुख्य भाग
{ "aggregateBy": [{ "dataSourceId": "derived:com.google.step_count.delta:com.google.android.gms:estimated_steps" }], "bucketByTime": { "durationMillis": 86400000 }, "startTimeMillis": 1454284800000, "endTimeMillis": 1455062400000 }
- जवाब
अगर डेटा सोर्स मौजूद हैं, तो रिस्पॉन्स
200 OK
स्टेटस कोड होगा. रिस्पॉन्स के मुख्य हिस्से में डेटा सोर्स की JSON के हिसाब से जानकारी दी जाती है.- कर्ल निर्देश
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X POST \ --header "Content-Type: application/json;encoding=utf-8" -d @aggregate.json \ "https://www.googleapis.com/fitness/v1/users/me/dataset:aggregate"
डेटा सोर्स अपडेट करना
इस उदाहरण में, किसी डेटा सोर्स के नाम और डिवाइस के वर्शन को अपडेट करने का तरीका बताया गया है.
- एचटीटीपी मेथड
- PUT
- URL का अनुरोध करें
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
- अनुरोध का मुख्य भाग
{ "dataStreamId": "derived:com.google.step_count.delta:1234567890:Example Manufacturer:ExampleTablet:1000001:MyDataSource", "dataStreamName": "MyDataSource", "type": "derived", "application": { "detailsUrl": "http://example.com", "name": "Foo Example App", "version": "1" }, "dataType": { "field": [ { "name": "steps", "format": "integer" } ], "name": "com.google.step_count.delta" }, "device": { "manufacturer": "Example Manufacturer", "model": "ExampleTablet", "type": "tablet", "uid": "1000001", "version": "2.0" } }
- जवाब
अगर डेटा सोर्स अपडेट हो गया है, तो रिस्पॉन्स
200 OK
स्टेटस कोड के तौर पर दिखेगा. जवाब के मुख्य भाग में डेटा स्रोत के JSON का प्रतिनिधित्व होता है.- कर्ल निर्देश
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X PUT \ --header "Content-Type: application/json;encoding=utf-8" -d @updateds.json \ "https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource"
डेटा सोर्स मिटाना
इस उदाहरण में डेटा सोर्स को मिटाने का तरीका बताया गया है.
- एचटीटीपी मेथड
- मिटाएं
- URL का अनुरोध करें
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
- अनुरोध का मुख्य भाग
- कोई नहीं
- जवाब
- अगर डेटा स्रोत सफलतापूर्वक मिटा दिया गया है, तो जवाब
200 OK
स्थिति कोड होगा. जवाब के मुख्य भाग में डेटा स्रोत का JSON प्रतिनिधित्व होता है, जिसे मिटा दिया गया है. - कर्ल निर्देश
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X DELETE \ --header "Content-Type: application/json;encoding=utf-8" \ "https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource"