Veri kümesi, veri noktaları için projeksiyon container'ını temsil eder. Bu mülkler kendi bilgilerini taşımaz. Veri kümeleri, belirli bir veri kaynağından alınmış bir dizi veri noktasını temsil eder. Bir veri noktası birden fazla veri kümesinde bulunabilir.
Bu kaynağa yönelik yöntemlerin 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 olası kısmi kısmi temsilinde tüm veri noktalarının en büyük bitiş zamanı. Epoch'tan itibaren nano saniye cinsinden süre. Bu değer, veri kümesi tanımlayıcısının ikinci kısmıyla da eşleşmelidir. | |
minStartTimeNs |
long |
Veri kümesinin bu kısmi temsilinde muhtemelen tüm veri noktalarının en kısa başlangıç zamanıdır. Epoch'tan itibaren nano saniye cinsinden süre. Bu veri kümesi tanımlayıcısının ilk kısmıyla da eşleşmelidir. | |
nextPageToken |
string |
Bu jeton, bir GET isteğine yanıt olarak bir veri kümesi alındığında ve veri kümesi, tek bir yanıta dahil edilemeyecek kadar büyük olduğunda ayarlanır. Bu veri kümesindeki veri noktalarının bir sonraki sayfasını döndürmek için sonraki bir GET isteğinde bu değeri sağlayın. | |
point[] |
list |
Veri kümesinde yer alan ve bitişTimeNanos'a göre sıralanmış veri noktalarının kısmi listesi. Bu liste, küçük bir veri kümesi alınırken tam, tek bir veri kümesine yama yapan veya tek bir yanıta dahil edilemeyecek kadar büyük bir veri kümesi alınırken de tam olarak kabul edilir. | |
point[].computationTimeMillis |
long |
BU ALANI KULLANMAYIN. Yoksayılır ve saklanmaz. | |
point[].dataTypeName |
string |
Bu veri noktasındaki değerlerin biçimini tanımlayan veri türü. | |
point[].endTimeNanos |
long |
Bu veri noktasıyla temsil edilen aralığın bitiş zamanı, dönemden beri nanosaniye olarak. | |
point[].modifiedTimeMillis |
long |
Bu veri noktasının en son ne zaman değiştirildiğini belirtir. Verilerin mevcut durumunu göstermek yerine sadece veri değişikliklerini listelediğimiz bağlamlarda kullanışlıdır. | |
point[].originDataSourceId |
string |
Veri noktası, türetilmiş bir veri kaynağı için veri kümesinde yer alıyorsa bu alan, başlangıçta veri noktasını oluşturan veri kaynağı akış kimliğiyle doldurulur. UYARI: Hata ayıklama dışında hiçbir alanda bu alana güvenmeyin. Bu alanın değeri (hiçbirine ayarlanırsa) bir uygulama ayrıntısıdır ve tutarlı olacağı garanti edilmez. |
|
point[].rawTimestampNanos |
long |
Orijinal SensorEvent'teki ham zaman damgası. | |
point[].startTimeNanos |
long |
Bu veri noktasıyla temsil edilen aralığın, dönemden itibaren nanosaniye cinsinden başlangıç zamanı. | |
point[].value[] |
list |
Veri noktası için her bir veri türü alanının değerleri. Bir veri türü alanına karşılık gelen her değerin, alanın bir veri kaynağında belirtilen veri türünde listelendiği sırayla gerçekleşmesi beklenir. Veri kaynağı türü alanındaki biçim enum 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 ayarlandığında diğer değerler ayarlanmamalıdır. | |
point[].value[].intVal |
integer |
Tam sayı değeri. Bu ayarlandığında diğer değerler ayarlanmamalıdır. | |
point[].value[].mapVal[] |
list |
Harita değeri. Her bir girişin ilgili değeri için geçerli anahtar alanı ve birimleri, veri türü tanımının bir parçası olarak belgelenmelidir. Anahtarlar mümkün olduğunca küçük tutulmalıdır. Büyük anahtarlara ve yüksek veri sıklığına sahip veri akışları düşük düzeyde örneklenebilir. | |
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 ayarlandığında diğer değerler ayarlanmamalıdır. Dizeler mümkün olduğunca küçük tutulmalıdır. Büyük dize değerlerine ve yüksek veri sıklığına sahip veri akışları düşük örnekleme yapılabilir. |
Yöntemler
- sil
- Başlangıç ve bitiş zamanlarının, veri kümesi kimliğiyle belirtilen zaman aralığıyla çakıştığı tüm veri noktalarının kapsayıcı bir şekilde silme işlemini gerçekleştirir. Çoğu veri türünde veri noktasının tamamı silinir. Zaman aralığının tutarlı bir değeri (
com.google.activity.segment
gibi) temsil ettiği ve veri noktasının, veri kümesinin her iki ucunda da durduğu veri türlerinde yalnızca veri noktasının çakışan bölümü silinir. - al
- Başlangıç ve bitiş zamanlarının, belirtilen veri kümesi minimum başlangıç zamanı ve maksimum bitiş zamanı aralığıyla çakışan tüm veri noktalarını içeren bir veri kümesini döndürür. Özellikle, başlangıç zamanı veri kümesinin bitiş zamanına eşit veya bundan kısa olan ve bitiş zamanı veri kümesinin başlangıç zamanına eşit veya bundan daha uzun olan tüm veri noktaları.
- yama
- Veri kümesine veri noktaları ekler. Veri kümesinin önceden oluşturulması gerekmez.
Belirli bir veri kümesindeki tüm noktalar, bu veri kümesini almak için daha sonra yapılan çağrılarla birlikte döndürülür. Veri noktaları birden fazla veri kümesine ait olabilir.
Bu yöntem, yama semantiği kullanmaz: Sağlanan veri noktaları, değiştirilmeden yalnızca mevcut veriler değiştirilmez.