Users.dataSources.datasets

Veri kümesi, veri noktaları için bir projeksiyon kapsayıcısını temsil eder. Kendi bilgilerini taşımazlar. Veri kümeleri, belirli bir veri kaynağından alınan veri noktalarını temsil eder. Bir veri noktası, birden fazla veri kümesinde bulunabilir.

Bu kaynağa yönelik yöntem listesi için bu sayfanın sonuna bakın.

Kaynak temsilleri

{
  "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
}
Mülk adı Değer Açıklama Notlar
dataSourceId string Bu veri kümesindeki noktaları oluşturan veri kaynağının veri akışı kimliği.
maxEndTimeNs long Veri kümesinin bu muhtemelen kısmi gösterimindeki tüm veri noktalarının en büyük bitiş zamanı. Zaman, dönemden itibaren nanosaniye cinsindendir. Bu, veri kümesi tanımlayıcısının ikinci kısmıyla da eşleşmelidir.
minStartTimeNs long Veri kümesinin bu muhtemelen kısmi gösterimindeki tüm veri noktalarının en kısa başlangıç zamanı. Zaman, dönemden itibaren nanosaniye cinsindendir. Bu değer, veri kümesi tanımlayıcısının ilk kısmıyla da eşleşmelidir.
nextPageToken string Bu jeton, GET isteğine yanıt olarak bir veri kümesi alındığında ve veri kümesi tek bir yanıta eklenemeyecek kadar büyük olduğunda ayarlanır. Bu veri kümesindeki veri noktalarının sonraki sayfasını döndürmek için sonraki bir GET isteğinde bu değeri sağlayın.
point[] list Veri kümesinde bulunan veri noktalarının, endTimeNanos'a göre sıralanmış kısmi bir listesi. Bu liste, küçük bir veri kümesi alınırken, bir veri kümesine yama uygulanırken veya tek bir yanıta dahil edilemeyecek kadar büyük bir veri kümesi alınırken kısmi olarak kabul edilir.
point[].computationTimeMillis long BU ALANI KULLANMAYIN. Yoksayılır ve depolanmaz.
point[].dataTypeName string Bu veri noktasındaki değerlerin biçimini belirleyen veri türü.
point[].endTimeNanos long Dönemden bu yana geçen nanosaniye cinsinden, bu veri noktasının temsil ettiği aralığın bitiş zamanı.
point[].modifiedTimeMillis long Bu veri noktasının en son ne zaman değiştirildiğini gösterir. Verilerin mevcut durumunu temsil etmek yerine yalnızca veri değişikliklerini listelediğimiz bağlamlarda kullanışlıdır.
point[].originDataSourceId string Veri noktası, türetilmiş bir veri kaynağının veri kümesinde yer alıyorsa bu alan, veri noktasını başlangıçta oluşturan veri kaynağı akış kimliğiyle doldurulur.

UYARI: Hata ayıklama dışında hiçbir şey için bu alana güvenmeyin. Bu alanın değeri ayarlanmışsa (eğer ayarlanmışsa) bir uygulama ayrıntısıdır ve tutarlı kalacağı garanti edilmez.
point[].rawTimestampNanos long Orijinal SensorEvent'teki ham zaman damgasıdır.
point[].startTimeNanos long Dönemden bu yana geçen nanosaniye cinsinden, bu veri noktasının temsil ettiği aralığın başlangıç zamanı.
point[].value[] list Veri noktası için her veri türü alanının değerleri. Bir veri türü alanına karşılık gelen her değerin, alanın veri kaynağında belirtilen veri türünde listelendiği aynı sırayla gerçekleşmesi beklenir.

Veri kaynağının tür alanındaki biçim sıralaması değerine bağlı olarak, tam sayı ve kayan nokta alanlarından yalnızca biri doldurulur.

point[].value[].fpVal double Kayan nokta değeri. Bu ayarlanırsa diğer değerler ayarlanmamalıdır.
point[].value[].intVal integer Tam sayı değeri. Bu ayarlanırsa diğer değerler ayarlanmamalıdır.
point[].value[].mapVal[] list Harita değeri. Her girişin karşılık gelen değeri için geçerli anahtar alanı ve birimler, veri türü tanımının bir parçası olarak belgelenmelidir. Anahtarlar mümkünse küçük tutulmalıdır. Büyük anahtarları ve yüksek veri sıklığına sahip veri akışlarından örnek alınabilir.
point[].value[].mapVal[].key string
point[].value[].mapVal[].value nested object
point[].value[].mapVal[].value.fpVal double Kayan nokta değeri.
point[].value[].stringVal string Dize değeri. Bu ayarlanırsa diğer değerler ayarlanmamalıdır. Dizeler mümkünse kısa tutulmalıdır. Büyük dize değerleri ve yüksek veri sıklığına sahip veri akışları örneklenebilir.

Yöntemler

sil
Başlangıç ve bitiş zamanları olan tüm veri noktalarını dahil ederek siler veri kümesi kimliği tarafından belirtilen zaman aralığıyla çakışıyordur. Çoğu veri türlerini seçerseniz veri noktasının tamamı silinir. Etiketin zaman aralığı tutarlı bir değeri temsil eder (örneğin, com.google.activity.segment) ve bir veri noktası katmanları veri kümesinin ucundan birinde, verilerin yalnızca çakışan kısmıyla nokta silinecek.
al
Başlangıç ve bitiş zamanları olan tüm veri noktalarını içeren bir veri kümesini döndürür belirtilen veri kümesi minimum başlangıç zamanı aralığıyla çakışır ve maksimum bitiş süresini belirleyin. Özellikle, başlangıç zamanı daha kısa olan tüm veri noktaları veri kümesi bitiş zamanına eşit veya daha büyük olan; bitiş zamanı şundan büyük: veri kümesi başlangıç zamanına eşittir.
yama
Bir veri kümesine veri noktaları ekler. Veri kümesinin daha önce oluşturulması gerekmez. Belirtilen veri kümesindeki tüm noktalar sonraki çağrılarla döndürülür kullanabilirsiniz. Veri noktaları, birden fazla veri kümesine ait olabilir.

Bu yöntem yama semantiğini kullanmaz: Sağlanan veri noktaları mevcut veriler değiştirilmeden yalnızca eklendi.