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

हो
deletedSession[].activeTimeMillis long सेशन चालू रहने का समय. start_time_milis और end_time_milis, पूरे सेशन का समय तय करते हैं, लेकिन ऐक्टिव समय को कम किया जा सकता है और इसे activity_time_milis के हिसाब से तय किया जा सकता है. अगर सेशन के दौरान ऐक्टिव न रहने का समय पता हो, तो उसे com.google.activity.segment डेटा पॉइंट के ज़रिए भी शामिल करना चाहिए, जिसमें गतिविधि की वैल्यू

हो
hasMoreData boolean यह बताने के लिए फ़्लैग करें कि सर्वर के पास ट्रांसफ़र करने के लिए ज़्यादा डेटा है. इस फ़ील्ड का इस्तेमाल न करें. इसकी जानकारी, सर्वर से मिलने वाले रिस्पॉन्स में कभी अपने-आप नहीं भरती.

इसे आज़माएं!

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