दिए गए सेशन को अपडेट करता है या शामिल करता है. इसे अभी आज़माएं.
अनुरोध
एचटीटीपी अनुरोध
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_miles और end_time_miles पूरे सेशन का समय बताते हैं. हालांकि, ऐक्टिव रहने का समय कम हो सकता है. साथ ही, इसे activity_time_miles से तय किया जा सकता है. अगर सेशन के दौरान, इनऐक्टिव टाइम का पता चलता है, तो इसे 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_miles और end_time_miles पूरे सेशन का समय बताते हैं. हालांकि, ऐक्टिव रहने का समय कम हो सकता है. साथ ही, इसे activity_time_miles से तय किया जा सकता है. अगर सेशन के दौरान, इनऐक्टिव टाइम का पता चलता है, तो इसे com.google.activity.segment डेटा पॉइंट की मदद से अभी भी गतिविधि वैल्यू के साथ डाला जाना चाहिए |
इसे आज़माएं!
लाइव डेटा पर इस तरीके को कॉल करने और रिस्पॉन्स देखने के लिए, नीचे दिया गया एपीआई एक्सप्लोरर इस्तेमाल करें.