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 की शुरुआत से लेकर 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 1970 के बाद से शुरुआत का समय, मिलीसेकंड में.
session[].endTimeMillis long 1970 के बाद से अब तक के खत्म होने का समय, मिलीसेकंड में.
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 1970 के बाद से शुरुआत का समय, मिलीसेकंड में.
deletedSession[].endTimeMillis long 1970 के बाद से अब तक के खत्म होने का समय, मिलीसेकंड में.
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 सेशन चालू रहने का समय. प्रारंभ_समय_मिली और end_time_मिली में पूरे सत्र के समय को परिभाषित किया जाता है, लेकिन सक्रिय समय को छोटा किया जा सकता है और यहएक्टिव_समय_मिली से तय किया जा सकता है. अगर सेशन के दौरान, इस्तेमाल न होने वाले समय की जानकारी होती है, तो यह एक com.google.activity.सेगमेंट डेटा पॉइंट के ज़रिए भी डाला जाना चाहिए. इसके लिए, एसटीआईएलएल गतिविधि की वैल्यू

होनी चाहिए
deletedSession[].activeTimeMillis long सेशन चालू रहने का समय. प्रारंभ_समय_मिली और end_time_मिली में पूरे सत्र के समय को परिभाषित किया जाता है, लेकिन सक्रिय समय को छोटा किया जा सकता है और यहएक्टिव_समय_मिली से तय किया जा सकता है. अगर सेशन के दौरान, इस्तेमाल न होने वाले समय की जानकारी होती है, तो यह एक com.google.activity.सेगमेंट डेटा पॉइंट के ज़रिए भी डाला जाना चाहिए. इसके लिए, एसटीआईएलएल गतिविधि की वैल्यू

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

इसे आज़माएं!

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