इस एपीआई का रेफ़रंस, संसाधन टाइप के हिसाब से व्यवस्थित किया गया है. हर तरह के संसाधन में एक या उससे ज़्यादा डेटा के साथ एक या एक से ज़्यादा तरीके होते हैं.
संसाधन किस तरह के हैं
- Users.dataSources
- Users.dataSources.dataPointChanges
- Users.dataSources.datasets
- Users.dataset
- User.sessions
users.dataSources
User.dataSources संसाधन विवरण के लिए, संसाधन प्रतिनिधित्व पेज देखें.
| तरीका | एचटीटीपी अनुरोध | जानकारी |
|---|---|---|
| https://www.googleapis.com/fitness/v1/users के मुकाबले यूआरआई, जब तक कि कुछ और न बताया गया हो | ||
| बनाना |
POST /userId/dataSources
|
एक नया डेटा सोर्स बनाता है जो इस उपयोगकर्ता से जुड़े
सभी डेटा सोर्स में यूनीक होता है.
डेटा सोर्स, सेंसर डेटा का एक यूनीक सोर्स होता है. डेटा सोर्स, स्थानीय या साथी डिवाइसों के हार्डवेयर सेंसर से मिलने वाले रॉ डेटा का पता लगा सकते हैं. वे डेटा के अन्य स्रोतों को बदलकर या मर्ज करके हासिल किया गया डेटा भी दिखा सकते हैं. एक ही तरह के डेटा के लिए कई डेटा सोर्स मौजूद हो सकते हैं. फ़िटनेस एपीआई में शामिल या उससे पढ़े गए हर डेटासेट में, हर डेटा पॉइंट का एक डेटा स्रोत होता है. हर डेटा सोर्स, डेटासेट के अपडेट की एक यूनीक स्ट्रीम बनाता है और डेटा सोर्स का एक यूनीक आइडेंटिफ़ायर होता है. डेटा सोर्स में किए गए सभी बदलाव, डेटा स्ट्रीम आईडी पर असर नहीं डालते हैं. इसलिए, एक ही ऐप्लिकेशन/डिवाइस के अपडेट किए गए वर्शन से इकट्ठा किए गए डेटा को अब भी उसी डेटा सोर्स से जुड़ा माना जा सकता है. डेटा सोर्स की पहचान, सर्वर के ज़रिए जनरेट की गई स्ट्रिंग का इस्तेमाल करके की जाती है. यह स्ट्रिंग, बनाए जा रहे सोर्स के कॉन्टेंट के आधार पर तय की जाती है. इस तरीके को शुरू करते समय, dataStreamId
फ़ील्ड सेट नहीं किया जाना चाहिए. यह सर्वर से सही फ़ॉर्मैट में अपने-आप जनरेट होगा. अगर dataStreamId सेट किया गया है, तो यह उस फ़ॉर्मैट से मेल खाना चाहिए जो सर्वर जनरेट करेगा. यह फ़ॉर्मैट, डेटा सोर्स के कुछ फ़ील्ड का कॉम्बिनेशन होता है और इसमें एक खास ऑर्डर होता है. अगर यह मेल नहीं खाता, तो
अनुरोध पूरा नहीं होगा.
ऐसा डेटा टाइप तय करने से जो जानी-पहचानी नहीं है ("com.google." से शुरू) कस्टम डेटा टाइप वाला DataSource बनाएं. कस्टम डेटा टाइप को सिर्फ़ ऐसे ऐप्लिकेशन से पढ़ा जा सकता है जिसने उन्हें बनाया है. पसंद के मुताबिक डेटा के प्रकार का अब इस्तेमाल में नहीं है; इसके बजाय मानक डेटा का इस्तेमाल करें. डेटा सोर्स आईडी में शामिल डेटा सोर्स फ़ील्ड के अलावा, डेटा सोर्स बनाते समय पुष्टि किए गए डेवलपर प्रोजेक्ट नंबर को भी शामिल किया जाता है. जब सार्वजनिक डेटा टाइप को पढ़ने वाला कोई दूसरा डेवलपर, इसे पढ़ता है, तो यह डेवलपर प्रोजेक्ट नंबर अस्पष्ट होता है. |
| मिटाएं |
DELETE /userId/dataSources/dataSourceId
|
बताए गए डेटा स्रोत को मिटाता है. अगर डेटा सोर्स में कोई डेटा पॉइंट है, तो अनुरोध पूरा नहीं होगा. |
| पाएं |
GET /userId/dataSources/dataSourceId
|
बताए गए डेटा स्रोत को लौटाता है. |
| list |
GET /userId/dataSources
|
दिए गए OAuth दायरों का इस्तेमाल करके, डेवलपर को दिखने वाले सभी डेटा सोर्स की सूची बनाता है. यह सूची पूरी नहीं है; हो सकता है कि उपयोगकर्ता के पास निजी डेटा के ऐसे स्रोत हों जो सिर्फ़ दूसरे डेवलपर को दिखते हों या दूसरे स्कोप का इस्तेमाल करके कॉल करते हों. |
| अपडेट करें |
PUT /userId/dataSources/dataSourceId
|
बताए गए डेटा स्रोत को अपडेट करता है. version के अपवाद के साथ, dataStreamId, dataType, type, dataStreamName, और device प्रॉपर्टी में बदलाव नहीं किया जा सकता.
डेटा सोर्स की पहचान उनके dataStreamId से की जाती है.
|
Users.dataSources.dataPointChanges
User.dataSources.dataPointChanges संसाधन की जानकारी के लिए, संसाधन दिखाना पेज देखें.
| तरीका | एचटीटीपी अनुरोध | जानकारी |
|---|---|---|
| https://www.googleapis.com/fitness/v1/users के मुकाबले यूआरआई, जब तक कि कुछ और न बताया गया हो | ||
| list |
GET /userId/dataSources/dataSourceId/dataPointChanges
|
किसी खास डेटा सोर्स के लिए उपयोगकर्ता के डेटा पॉइंट में बदलाव होता है. |
users.dataSources.datasets
User.dataSources.datasets संसाधन की जानकारी के लिए, संसाधन प्रतिनिधित्व पेज देखें.
| तरीका | एचटीटीपी अनुरोध | जानकारी |
|---|---|---|
| https://www.googleapis.com/fitness/v1/users के मुकाबले यूआरआई, जब तक कि कुछ और न बताया गया हो | ||
| मिटाएं |
DELETE /userId/dataSources/dataSourceId/datasets/datasetId
|
ऐसे सभी डेटा पॉइंट को शामिल करके मिटा दिया जाता है जिनके शुरू और खत्म होने का समय, डेटासेट आईडी में दी गई समयसीमा से ओवरलैप होता हो. ज़्यादातर डेटा टाइप के लिए, पूरा डेटा पॉइंट मिटा दिया जाएगा. डेटा टाइप के लिए, जहां टाइम स्पैन एक जैसे मान (जैसे कि com.google.activity.segment) को दिखाता है और एक डेटा पॉइंट डेटासेट की सीमा को अलग करता है. डेटा पॉइंट के ओवरलैप होने वाले हिस्से को सिर्फ़ मिटा दिया जाता है.
|
| पाएं |
GET /userId/dataSources/dataSourceId/datasets/datasetId
|
इसमें ऐसे सभी डेटा पॉइंट वाले डेटासेट मिलते हैं जिनके शुरू और खत्म होने का समय, डेटासेट की तय की गई कम से कम समयसीमा और तय किए गए खत्म होने के समय से ओवरलैप होता है. खास तौर पर, ऐसा कोई भी डेटा पॉइंट जिसकी शुरुआत का समय, डेटासेट खत्म होने के समय से कम या उसके बराबर होता है और जिसका खत्म होने का समय डेटासेट शुरू होने के समय से ज़्यादा या बराबर होता है. |
| पैच |
PATCH /userId/dataSources/dataSourceId/datasets/datasetId
|
डेटासेट में डेटा पॉइंट जोड़ता है. डेटासेट को पहले नहीं बनाना चाहिए.
इस डेटासेट को फिर से पाने के लिए, दिए गए डेटासेट में मौजूद सभी पॉइंट को बाद के कॉल के साथ दिखाया जाएगा. डेटा पॉइंट एक से ज़्यादा डेटासेट से जुड़े हो सकते हैं.
इस तरीके में पैच सिमेंटिक का इस्तेमाल नहीं किया जाता है: दिए गए डेटा पॉइंट सिर्फ़ शामिल किए गए हैं, जिनमें कोई मौजूदा डेटा नहीं बदला गया है. |
users.dataset
उपयोगकर्ता.डेटासेट संसाधन की जानकारी के लिए, संसाधन दिखाने वाला पेज देखें.
| तरीका | एचटीटीपी अनुरोध | जानकारी |
|---|---|---|
| https://www.googleapis.com/fitness/v1/users के मुकाबले यूआरआई, जब तक कि कुछ और न बताया गया हो | ||
| एग्रीगेट |
POST /userId/dataset:aggregate
|
किसी दिए गए टाइप की सीमा से भाग देने पर, किसी खास तरह का डेटा या बकेट में स्ट्रीम करता है. कई तरह के डेटा सोर्स और कई सोर्स से मिलने वाले कई डेटा सेट को, हर अनुरोध के लिए ठीक एक बकेट टाइप में जोड़ा जा सकता है. |
उपयोगकर्ता
उपयोगकर्ता सेशन के संसाधन की जानकारी के लिए, संसाधन दिखाने का तरीका पेज देखें.
| तरीका | एचटीटीपी अनुरोध | जानकारी |
|---|---|---|
| https://www.googleapis.com/fitness/v1/users के मुकाबले यूआरआई, जब तक कि कुछ और न बताया गया हो | ||
| मिटाएं |
DELETE /userId/sessions/sessionId
|
किसी दिए गए सत्र आईडी से तय किए गए सेशन को मिटाता है. |
| list |
GET /userId/sessions
|
पहले बनाए गए सेशन की सूची बनाता है. |
| अपडेट करें |
PUT /userId/sessions/sessionId
|
किसी सेशन को अपडेट किया जाता है या शामिल किया जाता है. |