पहले बनाए गए सेशन की सूची बनाता है. इसे अभी आज़माएं.
अनुरोध करें
एचटीटीपी अनुरोध
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 |
फ़्लैग करें, ताकि पता चल सके कि सर्वर के पास ट्रांसफ़र करने के लिए ज़्यादा डेटा है. इस फ़ील्ड का इस्तेमाल न करें. यह सर्वर से मिलने वाले जवाबों में कभी भी पॉप्युलेट नहीं होता. |
इसे आज़माएं!
इस तरीके को लाइव डेटा पर कॉल करने और जवाब देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.