यह सूची, पहले बनाए गए सेशन की सूची बनाती है. इसे अभी आज़माएं.
अनुरोध
एचटीटीपी अनुरोध
GET https://www.googleapis.com/fitness/v1/users/userId/sessions
पैरामीटर
पैरामीटर का नाम | मान | ब्यौरा |
---|---|---|
पाथ पैरामीटर | ||
userId |
string |
उस व्यक्ति के सेशन की सूची बनाएं जिसकी पहचान की गई है. यह बताने के लिए me का इस्तेमाल करें
की पुष्टि हो चुकी है. फ़िलहाल, सिर्फ़ me का इस्तेमाल किया जा सकता है.
|
वैकल्पिक क्वेरी पैरामीटर | ||
activityType |
integer |
अगर खाली नहीं है, तो सिर्फ़ इस तरह की गतिविधि वाले सेशन लौटाए जाने चाहिए. |
endTime |
string |
RFC3339 टाइमस्टैंप. सिर्फ़ शुरू और खत्म होने के समय के बीच खत्म होने वाले सेशन ही इसमें शामिल किए जाएंगे जवाब को प्राथमिकता दें. अगर इस समय को हटा दिया जाता है, लेकिन startTime बताया गया है, तो startTime से लेकर समय के आखिर तक के सभी सेशन वापस नहीं किया जाएगा. |
includeDeleted |
boolean |
अगर सही है और startTime और endTime, दोनों अगर मिटाया गया डेटा मौजूद नहीं है, तो मिटाए गए सेशन फिर से दिखाए जाएंगे. |
pageToken |
string |
कंटिन्यूएशन टोकन, जिसका इस्तेमाल इंक्रीमेंटल सिंक होने के लिए किया जाता है.
बदलावों का अगला बैच पाने के लिए, इस पैरामीटर को
पिछले जवाब से nextPageToken . पेज टोकन यह है
शुरू या खत्म होने का समय बताया गया हो, तो अनदेखा कर दिया जाता है. अगर शुरू करने का कोई समय नहीं है,
खत्म होने का समय और पेज टोकन की जानकारी दी जाती है, तो सेशन
30 दिन लौटाए जाते हैं.
|
startTime |
string |
RFC3339 टाइमस्टैंप. सिर्फ़ शुरू और खत्म होने के समय के बीच खत्म होने वाले सेशन ही इसमें शामिल किए जाएंगे जवाब को प्राथमिकता दें. अगर इस समय को हटा दिया जाता है, लेकिन endTime तय किया गया है, तो समय की शुरुआत से endTime तक के सभी सेशन वापस किया गया. |
अनुमति देना
इस अनुरोध के लिए, इनमें से कम से कम एक दायरे की अनुमति लेना ज़रूरी है:
दायरा |
---|
https://www.googleapis.com/auth/fitness.activity.read |
https://www.googleapis.com/auth/fitness.activity.write |
https://www.googleapis.com/auth/fitness.location.read |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.read |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.read |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.read |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.read |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.read |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.read |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.read |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
ज़्यादा जानकारी के लिए, पुष्टि करने और अनुमति देने की जानकारी वाला पेज देखें.
अनुरोध का मुख्य भाग
इस तरीके के साथ अनुरोध का मुख्य हिस्सा न दें.
जवाब
सही तरीके से काम करने पर, यह तरीका इस स्ट्रक्चर के साथ रिस्पॉन्स का मुख्य हिस्सा दिखाता है:
{ "session": [ { "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 } ], "deletedSession": [ { "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 } ], "nextPageToken": string, "hasMoreData": boolean }
प्रॉपर्टी का नाम | मान | ब्यौरा | नोट |
---|---|---|---|
session[] |
list |
खत्म होने का समय, अनुरोध के startTime और endTime के बीच है. |
|
session[].id |
string |
क्लाइंट का जनरेट किया गया ऐसा आइडेंटिफ़ायर जो इस उपयोगकर्ता के मालिकाना हक वाले सभी सेशन के लिए यूनीक होता है. | |
session[].name |
string |
सेशन का ऐसा नाम जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. | |
session[].description |
string |
इस सेशन के लिए ब्यौरा. | |
session[].startTimeMillis |
long |
Epoch के बाद से मिलीसेकंड में, शुरू होने का समय. इसमें समय भी शामिल होता है. | |
session[].endTimeMillis |
long |
Epoch के बाद से मिलीसेकंड में, खत्म होने का समय शामिल है. | |
session[].modifiedTimeMillis |
long |
इस टाइमस्टैंप से पता चलता है कि सेशन में आखिरी बार कब बदलाव किया गया था. | |
session[].application |
nested object |
वह ऐप्लिकेशन जिससे सेशन बनाया गया. | |
session[].application.packageName |
string |
इस ऐप्लिकेशन के लिए पैकेज नाम. Android ऐप्लिकेशन में बनाए जाते समय इसका इस्तेमाल एक यूनीक आइडेंटिफ़ायर के तौर पर किया जाता है. हालांकि, REST क्लाइंट इसे तय नहीं कर सकता. REST क्लाइंट को अपना डेवलपर प्रोजेक्ट नंबर, डेटा सोर्स के डेटा स्ट्रीम आईडी में PackageName के बजाय नया नंबर दिखेगा. | |
session[].application.version |
string |
ऐप्लिकेशन का वर्शन. जब भी ऐप्लिकेशन में कोई ऐसा बदलाव हो जिससे डेटा के कंप्यूटेशन पर असर पड़े, तो आपको इस फ़ील्ड को अपडेट करना चाहिए. | |
session[].application.detailsUrl |
string |
एक वैकल्पिक यूआरआई, जिसका इस्तेमाल ऐप्लिकेशन से वापस लिंक करने के लिए किया जा सकता है. | |
session[].application.name |
string |
इस ऐप्लिकेशन का नाम. REST क्लाइंट के लिए यह ज़रूरी है, लेकिन हम इस नाम की खासियत को लागू नहीं करते. यह सुविधा उन दूसरे डेवलपर के लिए है जो यह जानना चाहते हैं कि किस REST ने ऐप्लिकेशन या डेटा सोर्स बनाया है. | |
session[].activityType |
integer |
इस सेशन में जिस तरह की गतिविधि दिखाई जाती है. | |
deletedSession[] |
list |
अगर अनुरोध में includeDeleted को 'सही है' पर सेट किया गया है और startTime और endTime को शामिल नहीं किया गया है, तो इसमें वे सेशन भी शामिल होंगे जिन्हें पिछली बार सिंक होने के बाद मिटा दिया गया था. |
|
deletedSession[].id |
string |
क्लाइंट का जनरेट किया गया ऐसा आइडेंटिफ़ायर जो इस उपयोगकर्ता के मालिकाना हक वाले सभी सेशन के लिए यूनीक होता है. | |
deletedSession[].name |
string |
सेशन का ऐसा नाम जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है. | |
deletedSession[].description |
string |
इस सेशन के लिए ब्यौरा. | |
deletedSession[].startTimeMillis |
long |
Epoch के बाद से मिलीसेकंड में, शुरू होने का समय. इसमें समय भी शामिल होता है. | |
deletedSession[].endTimeMillis |
long |
Epoch के बाद से मिलीसेकंड में, खत्म होने का समय शामिल है. | |
deletedSession[].modifiedTimeMillis |
long |
इस टाइमस्टैंप से पता चलता है कि सेशन में आखिरी बार कब बदलाव किया गया था. | |
deletedSession[].application |
nested object |
वह ऐप्लिकेशन जिससे सेशन बनाया गया. | |
deletedSession[].application.packageName |
string |
इस ऐप्लिकेशन के लिए पैकेज नाम. Android ऐप्लिकेशन में बनाए जाते समय इसका इस्तेमाल एक यूनीक आइडेंटिफ़ायर के तौर पर किया जाता है. हालांकि, REST क्लाइंट इसे तय नहीं कर सकता. REST क्लाइंट को अपना डेवलपर प्रोजेक्ट नंबर, डेटा सोर्स के डेटा स्ट्रीम आईडी में PackageName के बजाय नया नंबर दिखेगा. | |
deletedSession[].application.version |
string |
ऐप्लिकेशन का वर्शन. जब भी ऐप्लिकेशन में कोई ऐसा बदलाव हो जिससे डेटा के कंप्यूटेशन पर असर पड़े, तो आपको इस फ़ील्ड को अपडेट करना चाहिए. | |
deletedSession[].application.detailsUrl |
string |
एक वैकल्पिक यूआरआई, जिसका इस्तेमाल ऐप्लिकेशन से वापस लिंक करने के लिए किया जा सकता है. | |
deletedSession[].application.name |
string |
इस ऐप्लिकेशन का नाम. REST क्लाइंट के लिए यह ज़रूरी है, लेकिन हम इस नाम की खासियत को लागू नहीं करते. यह सुविधा उन दूसरे डेवलपर के लिए है जो यह जानना चाहते हैं कि किस REST ने ऐप्लिकेशन या डेटा सोर्स बनाया है. | |
deletedSession[].activityType |
integer |
इस सेशन में जिस तरह की गतिविधि दिखाई जाती है. | |
nextPageToken |
string |
आगे के बदलावों को सिंक करने के लिए इस्तेमाल किया जाने वाला सिंक टोकन. यह जानकारी सिर्फ़ तब दी जाएगी, जब startTime और endTime, दोनों को अनुरोध में शामिल न किया गया हो. | |
session[].activeTimeMillis |
long |
सेशन चालू रहने का समय. start_time_milis और end_time_milis, पूरे सेशन का समय तय करते हैं, लेकिन ऐक्टिव समय को कम किया जा सकता है और इसे Active_time_milis से तय किया जा सकता है. अगर सेशन के दौरान ऐक्टिव न रहने का समय पता हो, तो उसे com.google.activity.segment डेटा पॉइंट के ज़रिए भी शामिल करना चाहिए, जिसमें गतिविधि की वैल्यू हो |
|
deletedSession[].activeTimeMillis |
long |
सेशन चालू रहने का समय. start_time_milis और end_time_milis, पूरे सेशन का समय तय करते हैं, लेकिन ऐक्टिव समय को कम किया जा सकता है और इसे activity_time_milis के हिसाब से तय किया जा सकता है. अगर सेशन के दौरान ऐक्टिव न रहने का समय पता हो, तो उसे com.google.activity.segment डेटा पॉइंट के ज़रिए भी शामिल करना चाहिए, जिसमें गतिविधि की वैल्यू हो |
|
hasMoreData |
boolean |
यह बताने के लिए फ़्लैग करें कि सर्वर के पास ट्रांसफ़र करने के लिए ज़्यादा डेटा है. इस फ़ील्ड का इस्तेमाल न करें. इसकी जानकारी, सर्वर से मिलने वाले रिस्पॉन्स में कभी अपने-आप नहीं भरती. |
इसे आज़माएं!
लाइव डेटा पर इस तरीके को कॉल करने और जवाब देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.