Users.dataSources.datasets

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.