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

हो

इसे आज़माएं!

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