Users.dataSources.datasets

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

Bu kaynağa ilişkin 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 muhtemelen kısmen gösterilen tüm veri noktaları arasında en uzun bitiş zamanı. Zaman, sıfır zamandan itibaren nanosaniye cinsinden belirtilir. 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 muhtemelen kısmen gösterilen tüm veri noktaları için en kısa başlangıç zamanı. Zaman, sıfır zamandan itibaren nanosaniye cinsinden belirtilir. 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 dahil edilemeyecek kadar büyük olduğunda ayarlanır. Bu veri kümesindeki veri noktalarının sonraki sayfasını döndürmek için bu değeri sonraki bir GET isteğinde sağlayın.
point[]	list	Veri kümesindeki veri noktalarının endTimeNanos'a göre sıralanmış kısmi listesi. Bu liste, küçük bir veri kümesi alınırken tamamlanmış, bir veri kümesine yama uygulanırken veya tek bir yanıta eklenemeyecek 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 saklanmaz.
point[].dataTypeName	string	Bu veri noktasındaki değerlerin biçimini tanımlayan veri türü.
point[].endTimeNanos	long	Bu veri noktası tarafından temsil edilen aralığın bitiş zamanı (epoch'tan bu yana nanosaniye cinsinden).
point[].modifiedTimeMillis	long	Bu veri noktasının en son ne zaman değiştirildiğini gösterir. Verilerin mevcut durumunu göstermek yerine, yalnızca veri değişikliklerini listelediğimiz bağlamlarda yararlıdır.
point[].originDataSourceId	string	Veri noktası, türetilmiş bir veri kaynağına ait veri kümesinde bulunuyorsa bu alan, veri noktasını başlangıçta oluşturan veri kaynağı akış kimliğiyle doldurulur. UYARI: Bu alana hata ayıklama dışında başka bir amaçla güvenmeyin. Bu alanın değeri (ayarlanmışsa) bir uygulama ayrıntısıdır ve tutarlı olacağı garanti edilmez.
point[].rawTimestampNanos	long	Orijinal SensorEvent'in ham zaman damgası.
point[].startTimeNanos	long	Bu veri noktası tarafından temsil edilen aralığın, sıfır zamandan bu yana nanosaniye cinsinden başlangıç zamanı.
point[].value[]	list	Veri noktasıyla ilgili her bir veri türü alanının değerleri. Bir veri türü alanına karşılık gelen her bir değerin, alanın veri kaynağında belirtilen veri türünde listelendiği sırada gerçekleşmesi beklenir. Veri kaynağının 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 girişin karşılık gelen değerine ait geçerli anahtar alanı ve birimler, veri türü tanımının parçası olarak belgelenmelidir. Anahtarlar mümkün olduğunca küçük tutulmalıdır. Büyük anahtarlara ve yüksek veri frekansına sahip veri akışları düşük ö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ı aşağı örneklenebilir.

Yöntemler

sil

Başlangıç ve bitiş zamanları, veri kümesi kimliği tarafından belirtilen zaman aralığıyla çakışan tüm veri noktalarını kapsayıcı şekilde siler. Ç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 bir veri noktasının, veri kümesinin iki uç noktasından birinde yer aldığı veri türlerinde yalnızca veri noktasının çakışan kısmı silinir.

al

Başlangıç ve bitiş zamanları, 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ümesi döndürür. Özellikle, başlangıç zamanı veri kümesinin bitiş zamanından az veya ona eşit olan ve bitiş zamanı, veri kümesinin başlangıç zamanından büyük ya da ona eşit olan herhangi bir veri noktası.

yama

Bir veri kümesine veri noktaları ekler. Veri kümesinin önceden oluşturulmuş olması gerekmez. Belirtilen veri kümesindeki tüm noktalar, bu veri kümesini almak için yapılan sonraki çağrılarla 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ı, mevcut veriler değiştirilmeden yalnızca eklenir.