API Reference

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

रिसॉर्स टाइप

1. Users.dataSources
2. Users.dataSources.dataPointChanges
3. Users.dataSources.datasets
4. Users.dataset
5. Users.sessions

Users.dataSources

User.dataSources के संसाधन की जानकारी के लिए, संसाधन की जानकारी वाला पेज देखें.

तरीका	एचटीटीपी अनुरोध	कंपनी का ब्यौरा
https://www.googleapis.com/fitness/v1/users से जुड़े यूआरआई, जब तक अलग से न बताया गया हो
बनाएं	POST  /userId/dataSources	एक ऐसा नया डेटा सोर्स बनाता है जो इस उपयोगकर्ता से जुड़े सभी डेटा सोर्स से अलग हो. डेटा सोर्स, सेंसर डेटा का यूनीक सोर्स होता है. डेटा सोर्स, लोकल या कंपैनियन डिवाइसों पर हार्डवेयर सेंसर से आने वाला रॉ डेटा दिखा सकते हैं. वे दूसरे डेटा सोर्स को बदलकर या मर्ज करके बनाए गए डेटा को भी दिखा सकते हैं. एक ही तरह के डेटा के लिए, कई डेटा सोर्स मौजूद हो सकते हैं. Fitness API में डाले गए या उससे पढ़े गए हर डेटासेट में मौजूद हर डेटा पॉइंट से एक डेटा सोर्स जुड़ा होता है. हर डेटा सोर्स, एक यूनीक डेटा सोर्स आइडेंटिफ़ायर के साथ डेटासेट अपडेट की एक यूनीक स्ट्रीम बनाता है. डेटा सोर्स में किए जाने वाले सभी बदलाव, डेटा स्ट्रीम आईडी पर असर नहीं डालते. इस वजह से, एक ही ऐप्लिकेशन/डिवाइस के अपडेट किए गए वर्शन से इकट्ठा किए गए डेटा को अब भी एक ही डेटा सोर्स से जुड़ा माना जा सकता है. डेटा सोर्स की पहचान, सर्वर से जनरेट की गई स्ट्रिंग का इस्तेमाल करके की जाती है. यह पहचान, बनाए जा रहे सोर्स के कॉन्टेंट के आधार पर की जाती है. इस तरीके को शुरू करते समय, dataStreamId फ़ील्ड को सेट नहीं किया जाना चाहिए. यह सर्वर सही फ़ॉर्मैट के साथ अपने-आप जनरेट करेगा. अगर dataStreamId सेट है, तो यह सर्वर से जनरेट होने वाले फ़ॉर्मैट से मैच होना चाहिए. यह फ़ॉर्मैट, डेटा सोर्स के कुछ फ़ील्ड का कॉम्बिनेशन होता है और इसका एक खास क्रम होता है. अगर यह मेल नहीं खाता है, तो अनुरोध एक गड़बड़ी के साथ विफल हो जाएगा. अगर किसी ऐसे डेटा टाइप के बारे में बताना है जो आम तौर पर उपलब्ध नहीं है (जिस तरह का डेटा "com.google." से शुरू होता है), तो कस्टम डेटा टाइप वाला डेटा सोर्स बन जाएगा. कस्टम डेटा टाइप को सिर्फ़ उसी ऐप्लिकेशन से पढ़ा जा सकता है जिसने उन्हें बनाया है. कस्टम डेटा टाइप अब काम नहीं करते. इसके बजाय, स्टैंडर्ड डेटा टाइप का इस्तेमाल करें. डेटा सोर्स आईडी में शामिल डेटा सोर्स फ़ील्ड के अलावा, डेटा सोर्स बनाते समय पुष्टि किया गया डेवलपर प्रोजेक्ट नंबर भी शामिल होता है. जब कोई अन्य डेवलपर, सार्वजनिक डेटा टाइप को पढ़ता है, तब यह डेवलपर प्रोजेक्ट नंबर छिपा दिया जाता है.
मिटाएं	DELETE  /userId/dataSources/dataSourceId	बताए गए डेटा सोर्स को मिटाता है. अगर डेटा सोर्स में कोई भी डेटा पॉइंट है, तो अनुरोध पूरा नहीं हो पाएगा.
get	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	GET  /userId/dataSources/dataSourceId/datasets/datasetId	डेटासेट के शुरू होने और खत्म होने का समय, शुरू होने के कम से कम समय और खत्म होने के ज़्यादा से ज़्यादा समय की तय सीमा के साथ ओवरलैप करता है. खास तौर पर, ऐसा कोई भी डेटा पॉइंट जिसके शुरू होने का समय, डेटासेट के खत्म होने के समय से कम या उसके बराबर हो. साथ ही, जिसके खत्म होने का समय, डेटासेट के शुरू होने के समय से ज़्यादा या उसके बराबर हो.
पैच	PATCH  /userId/dataSources/dataSourceId/datasets/datasetId	डेटासेट में डेटा पॉइंट जोड़ता है. यह ज़रूरी नहीं है कि डेटासेट पहले से बनाया गया हो. इस डेटासेट को फिर से पाने के लिए, दिए गए डेटासेट में मौजूद सभी पॉइंट को बाद में कॉल किया जाएगा. डेटा पॉइंट एक से ज़्यादा डेटासेट से जुड़े हो सकते हैं. इस तरीके में, पैच सिमैंटिक का इस्तेमाल नहीं किया जाता: दिए गए डेटा पॉइंट सिर्फ़ डाले जाते हैं और मौजूदा डेटा को बदले बिना.

Users.dataset

User.dataset रिसॉर्स की जानकारी के लिए, संसाधन दिखाना पेज देखें.

तरीका	एचटीटीपी अनुरोध	कंपनी का ब्यौरा
https://www.googleapis.com/fitness/v1/users से जुड़े यूआरआई, जब तक अलग से न बताया गया हो
एग्रीगेट	POST  /userId/dataset:aggregate	किसी खास तरह के डेटा को इकट्ठा करता है या किसी खास तरह की सीमा के आधार पर बकेट में स्ट्रीम करता है. कई तरह के और कई सोर्स के कई डेटा सेट को हर अनुरोध के लिए, सिर्फ़ एक बकेट टाइप में एग्रीगेट किया जा सकता है.

Users.sessions

User.sessions संसाधन की जानकारी के लिए, संसाधन दिखाना पेज देखें.

तरीका	एचटीटीपी अनुरोध	कंपनी का ब्यौरा
https://www.googleapis.com/fitness/v1/users से जुड़े यूआरआई, जब तक अलग से न बताया गया हो
मिटाएं	DELETE  /userId/sessions/sessionId	दिए गए सेशन आईडी से तय किए गए सेशन को मिटाता है.
list	GET  /userId/sessions	पहले बनाए गए सेशन की सूची बनाता है.
अपडेट	PUT  /userId/sessions/sessionId	दिए गए सेशन को अपडेट करता है या शामिल करता है.