Users.sessions: list

ध्यान दें: इसके लिए, अनुमति की ज़रूरत होती है.

पहले बनाए गए सेशन की सूची बनाता है. इसे अभी आज़माएं.

अनुरोध

एचटीटीपी अनुरोध

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	फ़्लैग करके बताएं कि सर्वर के पास ट्रांसफ़र करने के लिए ज़्यादा डेटा है. इस फ़ील्ड का इस्तेमाल न करें. यह सर्वर से मिलने वाले रिस्पॉन्स में कभी शामिल नहीं होता.

इसे आज़माएं!

लाइव डेटा पर इस तरीके को कॉल करने और रिस्पॉन्स देखने के लिए, नीचे दिया गया एपीआई एक्सप्लोरर इस्तेमाल करें.