कोई सेशन अपडेट करना या कोई नया सेशन शामिल करना. इसे अभी आज़माएं.
अनुरोध
एचटीटीपी अनुरोध
PUT https://www.googleapis.com/fitness/v1/users/userId/sessions/sessionId
पैरामीटर
पैरामीटर का नाम | मान | ब्यौरा |
---|---|---|
पाथ पैरामीटर | ||
sessionId |
string |
बनाए जाने वाले सेशन का आईडी. |
userId |
string |
पहचाने गए व्यक्ति के लिए सेशन बनाएं. यह बताने के लिए me का इस्तेमाल करें
की पुष्टि हो चुकी है. फ़िलहाल, सिर्फ़ me का इस्तेमाल किया जा सकता है.
|
अनुमति देना
इस अनुरोध के लिए, नीचे दिए गए स्कोप वाले अनुमति की ज़रूरत है:
दायरा |
---|
https://www.googleapis.com/auth/fitness.activity.write |
ज़्यादा जानकारी के लिए, पुष्टि करने और अनुमति देने की जानकारी वाला पेज देखें.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर के साथ डेटा उपलब्ध कराएं:
{ "id": string, "name": string, "description": string, "startTimeMillis": long, "endTimeMillis": long, "modifiedTimeMillis": long, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "activityType": integer, "activeTimeMillis": long }
प्रॉपर्टी का नाम | मान | ब्यौरा | नोट |
---|---|---|---|
id |
string |
क्लाइंट का जनरेट किया गया ऐसा आइडेंटिफ़ायर जो इस उपयोगकर्ता के मालिकाना हक वाले सभी सेशन के लिए यूनीक होता है. | |
name |
string |
सेशन का ऐसा नाम जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. | |
description |
string |
इस सेशन के लिए ब्यौरा. | |
startTimeMillis |
long |
Epoch के बाद से मिलीसेकंड में, शुरू होने का समय. इसमें ये भी शामिल हैं. | |
endTimeMillis |
long |
Epoch के बाद से मिलीसेकंड में, खत्म होने का समय शामिल है. | |
modifiedTimeMillis |
long |
इस टाइमस्टैंप से पता चलता है कि सेशन में आखिरी बार कब बदलाव किया गया था. | |
application |
nested object |
वह ऐप्लिकेशन जिससे सेशन बनाया गया. | |
application.packageName |
string |
इस ऐप्लिकेशन के लिए पैकेज नाम. Android ऐप्लिकेशन में बनाए जाते समय इसका इस्तेमाल एक यूनीक आइडेंटिफ़ायर के तौर पर किया जाता है. हालांकि, REST क्लाइंट इसे तय नहीं कर सकता. REST क्लाइंट को अपना डेवलपर प्रोजेक्ट नंबर, डेटा सोर्स के डेटा स्ट्रीम आईडी में PackageName के बजाय नया नंबर दिखेगा. | |
application.version |
string |
ऐप्लिकेशन का वर्शन. जब भी ऐप्लिकेशन में ऐसा कोई बदलाव हो जिससे डेटा के कंप्यूटेशन पर असर पड़े, तो आपको इस फ़ील्ड को अपडेट करना चाहिए. | |
application.detailsUrl |
string |
एक वैकल्पिक यूआरआई, जिसका इस्तेमाल ऐप्लिकेशन से वापस लिंक करने के लिए किया जा सकता है. | |
application.name |
string |
इस ऐप्लिकेशन का नाम. REST क्लाइंट के लिए यह ज़रूरी है, लेकिन हम इस नाम की खासियत को लागू नहीं करते. यह सुविधा उन दूसरे डेवलपर के लिए है जो यह जानना चाहते हैं कि किस REST ने ऐप्लिकेशन या डेटा सोर्स बनाया है. | |
activityType |
integer |
इस सेशन में जिस तरह की गतिविधि दिखाई जाती है. | |
activeTimeMillis |
long |
सेशन चालू रहने का समय. start_time_milis और end_time_milis, पूरे सेशन का समय तय करते हैं, लेकिन ऐक्टिव समय को कम किया जा सकता है और इसे Active_time_milis से तय किया जा सकता है. अगर सेशन के दौरान ऐक्टिव न रहने का समय पता हो, तो उसे com.google.activity.segment डेटा पॉइंट के ज़रिए भी शामिल करना चाहिए, जिसमें गतिविधि की वैल्यू हो |
जवाब
सही तरीके से काम करने पर, यह तरीका इस स्ट्रक्चर के साथ रिस्पॉन्स का मुख्य हिस्सा दिखाता है:
{ "id": string, "name": string, "description": string, "startTimeMillis": long, "endTimeMillis": long, "modifiedTimeMillis": long, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "activityType": integer, "activeTimeMillis": long }
प्रॉपर्टी का नाम | मान | ब्यौरा | नोट |
---|---|---|---|
id |
string |
क्लाइंट का जनरेट किया गया ऐसा आइडेंटिफ़ायर जो इस उपयोगकर्ता के मालिकाना हक वाले सभी सेशन के लिए यूनीक होता है. | |
name |
string |
सेशन का ऐसा नाम जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. | |
description |
string |
इस सेशन के लिए ब्यौरा. | |
startTimeMillis |
long |
Epoch के बाद से मिलीसेकंड में, शुरू होने का समय. इसमें ये भी शामिल हैं. | |
endTimeMillis |
long |
Epoch के बाद से मिलीसेकंड में, खत्म होने का समय शामिल है. | |
modifiedTimeMillis |
long |
इस टाइमस्टैंप से पता चलता है कि सेशन में आखिरी बार कब बदलाव किया गया था. | |
application |
nested object |
वह ऐप्लिकेशन जिससे सेशन बनाया गया. | |
application.packageName |
string |
इस ऐप्लिकेशन के लिए पैकेज नाम. Android ऐप्लिकेशन में बनाए जाते समय इसका इस्तेमाल एक यूनीक आइडेंटिफ़ायर के तौर पर किया जाता है. हालांकि, REST क्लाइंट इसे तय नहीं कर सकता. REST क्लाइंट को अपना डेवलपर प्रोजेक्ट नंबर, डेटा सोर्स के डेटा स्ट्रीम आईडी में PackageName के बजाय नया नंबर दिखेगा. | |
application.version |
string |
ऐप्लिकेशन का वर्शन. जब भी ऐप्लिकेशन में ऐसा कोई बदलाव हो जिससे डेटा के कंप्यूटेशन पर असर पड़े, तो आपको इस फ़ील्ड को अपडेट करना चाहिए. | |
application.detailsUrl |
string |
एक वैकल्पिक यूआरआई, जिसका इस्तेमाल ऐप्लिकेशन से वापस लिंक करने के लिए किया जा सकता है. | |
application.name |
string |
इस ऐप्लिकेशन का नाम. REST क्लाइंट के लिए यह ज़रूरी है, लेकिन हम इस नाम की खासियत को लागू नहीं करते. यह सुविधा उन दूसरे डेवलपर के लिए है जो यह जानना चाहते हैं कि किस REST ने ऐप्लिकेशन या डेटा सोर्स बनाया है. | |
activityType |
integer |
इस सेशन में जिस तरह की गतिविधि दिखाई जाती है. | |
activeTimeMillis |
long |
सेशन चालू रहने का समय. start_time_milis और end_time_milis, पूरे सेशन का समय तय करते हैं, लेकिन ऐक्टिव समय को कम किया जा सकता है और इसे Active_time_milis से तय किया जा सकता है. अगर सेशन के दौरान ऐक्टिव न रहने का समय पता हो, तो उसे com.google.activity.segment डेटा पॉइंट के ज़रिए भी शामिल करना चाहिए, जिसमें गतिविधि की वैल्यू हो |
इसे आज़माएं!
लाइव डेटा पर इस तरीके को कॉल करने और जवाब देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.