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