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	शुरू होने का समय, epoch के बाद से मिलीसेकंड में.
endTimeMillis	long	epoch के बाद से मिलीसेकंड में, खत्म होने का समय. इसमें भी शामिल है.
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	सेशन के चालू रहने का समय. start_time_miles और end_time_miles पूरे सेशन का समय बताते हैं. हालांकि, ऐक्टिव रहने का समय कम हो सकता है. साथ ही, इसे activity_time_miles से तय किया जा सकता है. अगर सेशन के दौरान, इनऐक्टिव टाइम का पता चलता है, तो इसे com.google.activity.segment डेटा पॉइंट की मदद से अभी भी गतिविधि वैल्यू के साथ डाला जाना चाहिए

जवाब

अगर यह तरीका काम करता है, तो यह इस स्ट्रक्चर का इस्तेमाल करके रिस्पॉन्स का मुख्य हिस्सा दिखाता है:

{
  "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	शुरू होने का समय, epoch के बाद से मिलीसेकंड में.
endTimeMillis	long	epoch के बाद से मिलीसेकंड में, खत्म होने का समय. इसमें भी शामिल है.
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	सेशन के चालू रहने का समय. start_time_miles और end_time_miles पूरे सेशन का समय बताते हैं. हालांकि, ऐक्टिव रहने का समय कम हो सकता है. साथ ही, इसे activity_time_miles से तय किया जा सकता है. अगर सेशन के दौरान, इनऐक्टिव टाइम का पता चलता है, तो इसे com.google.activity.segment डेटा पॉइंट की मदद से अभी भी गतिविधि वैल्यू के साथ डाला जाना चाहिए

इसे आज़माएं!

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