Users.dataSources.datasets

डेटा पॉइंट के लिए, डेटासेट एक प्रोजेक्शन कंटेनर दिखाता है. उनके पास अपनी कोई जानकारी नहीं होती. डेटासेट, किसी डेटा सोर्स से डेटा पॉइंट का सेट दिखाते हैं. किसी डेटा पॉइंट को एक से ज़्यादा डेटासेट में देखा जा सकता है.

इस संसाधन के तरीकों की सूची के लिए, इस पेज का अंत देखें.

रिसॉर्स प्रतिनिधित्व

{
  "minStartTimeNs": long,
  "maxEndTimeNs": long,
  "dataSourceId": string,
  "point": [
    {
      "startTimeNanos": long,
      "endTimeNanos": long,
      "dataTypeName": string,
      "originDataSourceId": string,
      "value": [
        {
          "intVal": integer,
          "fpVal": double,
          "stringVal": string,
          "mapVal": [
            {
              "key": string,
              "value": {
                "fpVal": double
              }
            }
          ]
        }
      ],
      "modifiedTimeMillis": long,
      "rawTimestampNanos": long,
      "computationTimeMillis": long
    }
  ],
  "nextPageToken": string
}
प्रॉपर्टी का नाम वैल्यू कंपनी का ब्यौरा ज़रूरी जानकारी
dataSourceId string उस डेटा सोर्स का डेटा स्ट्रीम आईडी जिसने इस डेटासेट में पॉइंट बनाए.
maxEndTimeNs long डेटासेट के इस आंशिक रूप से दिखाए गए डेटा में, सभी डेटा पॉइंट के खत्म होने का सबसे बड़ा समय. समय, epoch से नैनोसेकंड में है. यह डेटासेट आइडेंटिफ़ायर के दूसरे हिस्से से भी मेल खाना चाहिए.
minStartTimeNs long डेटासेट के इस आंशिक रूप से दिखाए गए डेटा में, सभी डेटा पॉइंट के शुरू होने का सबसे छोटा समय. समय, epoch से नैनोसेकंड में है. यह डेटासेट आइडेंटिफ़ायर के पहले हिस्से से भी मेल खाना चाहिए.
nextPageToken string यह टोकन तब सेट किया जाएगा, जब GET अनुरोध के जवाब में डेटासेट मिलेगा और डेटासेट बहुत बड़ा है, इसलिए एक जवाब में शामिल नहीं किया जा सकता. इस डेटासेट में, डेटा पॉइंट का अगला पेज दिखाने के लिए, बाद के GET अनुरोध में यह वैल्यू दें.
point[] list डेटासेट में शामिल डेटा पॉइंट की आंशिक सूची, जो endTimeNanos के हिसाब से क्रम में होती है. किसी डेटासेट को पैच करते समय या बहुत बड़े डेटासेट को एक रिस्पॉन्स में शामिल करते समय, छोटे डेटासेट को वापस लाते समय, इस सूची को पूरी सूची माना जाता है.
point[].computationTimeMillis long इस फ़ील्ड का इस्तेमाल न करें. इसे अनदेखा कर दिया जाता है और सेव नहीं किया जाता.
point[].dataTypeName string ऐसा डेटा टाइप, जो इस डेटा पॉइंट में वैल्यू का फ़ॉर्मैट तय करता है.
point[].endTimeNanos long इस डेटा पॉइंट से दिखाए जाने वाले इंटरवल का खत्म होने का समय, जिसे epoch के बाद से नैनोसेकंड में दिखाया जाता है.
point[].modifiedTimeMillis long इससे पता चलता है कि इस डेटा पॉइंट में पिछली बार कब बदलाव किया गया था. इसका इस्तेमाल सिर्फ़ उन मामलों में किया जा सकता है जहां हम डेटा की मौजूदा स्थिति को दिखाने के बजाय, डेटा में किए गए बदलावों की सूची बना रहे हैं.
point[].originDataSourceId string अगर डिराइव्ड डेटा सोर्स के डेटासेट में डेटा पॉइंट शामिल है, तो यह फ़ील्ड उस डेटा सोर्स स्ट्रीम आईडी से भर जाएगा जिसने मूल रूप से डेटा पॉइंट बनाया था.

चेतावनी: डीबग करने के अलावा, किसी और चीज़ के लिए इस फ़ील्ड पर भरोसा न करें. अगर इस फ़ील्ड की वैल्यू को सेट किया गया है, तो यह लागू करने का तरीका है. साथ ही, इसके एक जैसे बने रहने की गारंटी नहीं है.
point[].rawTimestampNanos long मूल SensorEvent का रॉ टाइमस्टैंप.
point[].startTimeNanos long इस डेटा पॉइंट से दिखाए जाने वाले इंटरवल का शुरुआती समय, epoch के बाद से नैनोसेकंड में.
point[].value[] list डेटा पॉइंट के लिए हर डेटा टाइप फ़ील्ड की वैल्यू. यह उम्मीद की जाती है कि डेटा टाइप फ़ील्ड से जुड़ी हर वैल्यू उसी क्रम में होगी जिस क्रम में डेटा सोर्स में बताए गए डेटा टाइप में, फ़ील्ड को लिस्ट किया गया है.

डेटा सोर्स के टाइप फ़ील्ड में मौजूद फ़ॉर्मैट की वैल्यू के आधार पर, पूर्णांक और फ़्लोटिंग पॉइंट फ़ील्ड में से सिर्फ़ एक फ़ील्ड में अपने-आप जानकारी भरी जाएगी.

point[].value[].fpVal double फ़्लोटिंग पॉइंट की वैल्यू. अगर यह वैल्यू सेट है, तो अन्य वैल्यू को सेट नहीं किया जाना चाहिए.
point[].value[].intVal integer पूर्णांक मान. अगर यह वैल्यू सेट है, तो अन्य वैल्यू को सेट नहीं किया जाना चाहिए.
point[].value[].mapVal[] list मैप की वैल्यू. हर एंट्री से जुड़ी वैल्यू के लिए मान्य की स्पेस और इकाइयों को डेटा टाइप की परिभाषा के हिस्से के तौर पर दर्ज किया जाना चाहिए. जहां तक हो सके कुंजियां छोटी होनी चाहिए. बड़ी कुंजियों और ज़्यादा डेटा फ़्रीक्वेंसी वाली डेटा स्ट्रीम का सैंपल लिया जा सकता है.
point[].value[].mapVal[].key string
point[].value[].mapVal[].value nested object
point[].value[].mapVal[].value.fpVal double फ़्लोटिंग पॉइंट की वैल्यू.
point[].value[].stringVal string स्ट्रिंग का मान. अगर यह वैल्यू सेट है, तो अन्य वैल्यू को सेट नहीं किया जाना चाहिए. जब भी मुमकिन हो, स्ट्रिंग छोटी होनी चाहिए. बड़ी स्ट्रिंग वैल्यू और ज़्यादा डेटा फ़्रीक्वेंसी वाली डेटा स्ट्रीम का सैंपल लिया जा सकता है.

तरीके

मिटाएं
यह प्रोसेस उन सभी डेटा पॉइंट को एक साथ मिटा देती है जिनके शुरू और खत्म होने के समय, डेटासेट आईडी में बताई गई समयसीमा से ओवरलैप करते हैं. ज़्यादातर डेटा टाइप के लिए, पूरा डेटा पॉइंट मिटा दिया जाएगा. जिन डेटा टाइप में टाइम स्पैन, एक जैसी वैल्यू (जैसे कि com.google.activity.segment) दिखाता है और डेटा पॉइंट, डेटासेट के किसी भी आखिरी पॉइंट को स्ट्रैडल करता है वहां डेटा पॉइंट का ओवरलैप होने वाला हिस्सा ही मिटाया जाएगा.
get
ऐसे सभी डेटा पॉइंट वाला डेटासेट दिखाता है जिनके शुरू और खत्म होने का समय, डेटासेट के शुरू होने के कम से कम समय और ज़्यादा से ज़्यादा खत्म होने के समय की तय सीमा के साथ ओवरलैप करता है. खास तौर पर, ऐसा कोई भी डेटा पॉइंट जिसके शुरू होने का समय, डेटासेट के खत्म होने के समय से कम या उसके बराबर हो. साथ ही, जिसके खत्म होने का समय, डेटासेट के शुरू होने के समय से ज़्यादा या उसके बराबर हो.
पैच
डेटा पॉइंट को डेटासेट में जोड़ता है. यह ज़रूरी नहीं है कि डेटासेट पहले से बनाया गया हो. इस डेटासेट को फिर से पाने के लिए, दिए गए डेटासेट में मौजूद सभी पॉइंट को बाद में कॉल किया जाएगा. डेटा पॉइंट एक से ज़्यादा डेटासेट से जुड़े हो सकते हैं.

इस तरीके में, पैच सिमैंटिक का इस्तेमाल नहीं किया जाता: दिए गए डेटा पॉइंट सिर्फ़ डाले जाते हैं और मौजूदा डेटा को बदले बिना.