Users.sessions: update

ध्यान दें: अनुमति देना ज़रूरी है.

किसी सेशन को अपडेट किया जाता है या शामिल किया जाता है. इसे अभी आज़माएं.

अनुरोध करें

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

PUT https://www.googleapis.com/fitness/v1/users/userId/sessions/sessionId

पैरामीटर

पैरामीटर का नाम	वैल्यू	जानकारी
पाथ पैरामीटर
sessionId	string	सेशन का आईडी बनाया जाना चाहिए.
userId	string	व्यक्ति के लिए सेशन बनाएं. पुष्टि किए गए उपयोगकर्ता की जानकारी देने के लिए, me का इस्तेमाल करें. इस समय सिर्फ़ me के साथ काम करता है.

अनुमति देना

इस अनुरोध को नीचे दिए गए दायरे के साथ अनुमति की ज़रूरत है:

अनुमति देने का
https://www.googleapis.com/auth/fitness.activity.write

ज़्यादा जानकारी के लिए, पुष्टि करना और अनुमति देना पेज देखें.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में इस स्ट्रक्चर वाला डेटा दें:

{
  "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
}

प्रॉपर्टी का नाम	वैल्यू	जानकारी	नोट
id	string	क्लाइंट का जनरेट किया गया आइडेंटिफ़ायर, जो इस खास उपयोगकर्ता के मालिकाना हक वाले सभी सेशन में यूनीक होता है.
name	string	सेशन का ऐसा नाम जिसे लोग आसानी से पढ़ सकें.
description	string	इस सेशन के बारे में जानकारी.
startTimeMillis	long	1970 के बाद से शुरुआत का समय, मिलीसेकंड में.
endTimeMillis	long	1970 के बाद से अब तक के खत्म होने का समय, मिलीसेकंड में.
modifiedTimeMillis	long	टाइमस्टैंप से पता चलता है कि सेशन में पिछली बार कब बदलाव हुआ था.
application	nested object	सेशन बनाने वाला ऐप्लिकेशन.
application.packageName	string	इस ऐप्लिकेशन के पैकेज का नाम. Android ऐप्लिकेशन से बनाए जाने पर इसका इस्तेमाल एक खास पहचानकर्ता के रूप में किया जाता है. हालांकि, REST क्लाइंट की ओर से इसे तय नहीं किया जा सकता. REST के क्लाइंट का डेवलपर प्रोजेक्ट नंबर, packageName के बजाय डेटा सोर्स के डेटा स्ट्रीम आईडी में दिखेगा.
application.version	string	ऐप्लिकेशन का वर्शन. जब भी ऐप्लिकेशन इस तरह से बदलाव हो कि डेटा के कंप्यूटेशन पर असर पड़े, तब आपको इस फ़ील्ड को अपडेट करना चाहिए.
application.detailsUrl	string	एक वैकल्पिक यूआरआई जिसका इस्तेमाल ऐप्लिकेशन से वापस लिंक करने के लिए किया जा सकता है.
application.name	string	इस ऐप्लिकेशन का नाम. REST क्लाइंट के लिए यह ज़रूरी है, लेकिन हम इस नाम की खासियत लागू नहीं करते. यह सुविधा, उन डेवलपर के लिए सुविधा के तौर पर उपलब्ध कराई जाती है जो यह पता लगाना चाहते हैं कि किस REST से ऐप्लिकेशन या डेटा सोर्स बना है.
activityType	integer	इस सेशन में जिस तरह की गतिविधि होती है.
activeTimeMillis	long	सेशन चालू रहने का समय. प्रारंभ_समय_मिली और end_time_मिली में पूरे सत्र के समय को परिभाषित किया जाता है, लेकिन सक्रिय समय को छोटा किया जा सकता है और यहएक्टिव_समय_मिली से तय किया जा सकता है. अगर सेशन के दौरान, इस्तेमाल न होने वाले समय की जानकारी होती है, तो यह एक com.google.activity.सेगमेंट डेटा पॉइंट के ज़रिए भी डाला जाना चाहिए. इसके लिए, एसटीआईएलएल गतिविधि की वैल्यू होनी चाहिए

जवाब

अगर इस तरीके का इस्तेमाल किया जाता है, तो जवाब के मुख्य हिस्से में यह स्ट्रक्चर मौजूद होता है:

{
  "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
}

प्रॉपर्टी का नाम	वैल्यू	जानकारी	नोट
id	string	क्लाइंट का जनरेट किया गया आइडेंटिफ़ायर, जो इस खास उपयोगकर्ता के मालिकाना हक वाले सभी सेशन में यूनीक होता है.
name	string	सेशन का ऐसा नाम जिसे लोग आसानी से पढ़ सकें.
description	string	इस सेशन के बारे में जानकारी.
startTimeMillis	long	1970 के बाद से शुरुआत का समय, मिलीसेकंड में.
endTimeMillis	long	1970 के बाद से अब तक के खत्म होने का समय, मिलीसेकंड में.
modifiedTimeMillis	long	टाइमस्टैंप से पता चलता है कि सेशन में पिछली बार कब बदलाव हुआ था.
application	nested object	सेशन बनाने वाला ऐप्लिकेशन.
application.packageName	string	इस ऐप्लिकेशन के पैकेज का नाम. Android ऐप्लिकेशन से बनाए जाने पर इसका इस्तेमाल एक खास पहचानकर्ता के रूप में किया जाता है. हालांकि, REST क्लाइंट की ओर से इसे तय नहीं किया जा सकता. REST के क्लाइंट का डेवलपर प्रोजेक्ट नंबर, packageName के बजाय डेटा सोर्स के डेटा स्ट्रीम आईडी में दिखेगा.
application.version	string	ऐप्लिकेशन का वर्शन. जब भी ऐप्लिकेशन इस तरह से बदलाव हो कि डेटा के कंप्यूटेशन पर असर पड़े, तब आपको इस फ़ील्ड को अपडेट करना चाहिए.
application.detailsUrl	string	एक वैकल्पिक यूआरआई जिसका इस्तेमाल ऐप्लिकेशन से वापस लिंक करने के लिए किया जा सकता है.
application.name	string	इस ऐप्लिकेशन का नाम. REST क्लाइंट के लिए यह ज़रूरी है, लेकिन हम इस नाम की खासियत लागू नहीं करते. यह सुविधा, उन डेवलपर के लिए सुविधा के तौर पर उपलब्ध कराई जाती है जो यह पता लगाना चाहते हैं कि किस REST से ऐप्लिकेशन या डेटा सोर्स बना है.
activityType	integer	इस सेशन में जिस तरह की गतिविधि होती है.
activeTimeMillis	long	सेशन चालू रहने का समय. प्रारंभ_समय_मिली और end_time_मिली में पूरे सत्र के समय को परिभाषित किया जाता है, लेकिन सक्रिय समय को छोटा किया जा सकता है और यहएक्टिव_समय_मिली से तय किया जा सकता है. अगर सेशन के दौरान, इस्तेमाल न होने वाले समय की जानकारी होती है, तो यह एक com.google.activity.सेगमेंट डेटा पॉइंट के ज़रिए भी डाला जाना चाहिए. इसके लिए, एसटीआईएलएल गतिविधि की वैल्यू होनी चाहिए

इसे आज़माएं!

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