Users.dataSources

Sensör verileri için benzersiz bir kaynağın tanımı. Veri kaynakları, yerel veya tamamlayıcı cihazlardaki donanım sensörlerinden gelen ham verileri gösterebilir. Ayrıca, diğer veri kaynaklarını dönüştürerek veya birleştirerek türetilen verileri de gösterebilir. Aynı veri türü için birden çok veri kaynağı olabilir. Bu hizmete eklenen veya bu hizmetten okunan her veri noktasının ilişkili bir veri kaynağı vardır.

Veri kaynağı, verilerini benzersiz şekilde tanımlamak için yeterli miktarda bilgi içerir. Verileri içeren ve/veya dönüştüren donanım cihazı ile uygulama da buna dahildir. Ayrıca, donanım ve uygulama sürümleri ile cihaz türü gibi yararlı meta verileri de içerir.

Her veri kaynağı, benzersiz bir tanımlayıcıyla benzersiz bir veri akışı oluşturur. Veri kaynağında yapılan tüm değişiklikler akış tanımlayıcısını etkilemez. Bu nedenle, aynı uygulamanın/cihazın güncellenmiş sürümleri tarafından toplanan veriler aynı veri akışına ait olmaya devam edebilir.

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

Kaynak temsilleri

{
  "dataStreamId": string,
  "name": string,
  "dataStreamName": string,
  "type": string,
  "dataType": {
    "name": string,
    "field": [
      {
        "name": string,
        "format": string,
        "optional": boolean
      }
    ]
  },
  "device": {
    "uid": string,
    "type": string,
    "version": string,
    "model": string,
    "manufacturer": string
  },
  "application": {
    "packageName": string,
    "version": string,
    "detailsUrl": string,
    "name": string
  },
  "dataQualityStandard": [
    string
  ]
}

Mülk adı	Değer	Açıklama	Notlar
application	nested object	Sensör verilerini platforma besleyen bir uygulama hakkında bilgi.
application.detailsUrl	string	Uygulamaya yeniden bağlanmak için kullanılabilecek isteğe bağlı bir URI.
application.name	string	Bu uygulamanın adı. Bu, REST müşterileri için gereklidir, ancak bu adın benzersizliğini zorunlu kılmayız. Hangi REST'in Uygulama veya Veri Kaynağı oluşturduğunu belirlemek isteyen diğer geliştiricilere kolaylık sağlamak amacıyla sunulmaktadır.
application.packageName	string	Bu uygulamanın paket adı. Bu kimlik, Android uygulamaları tarafından benzersiz bir tanımlayıcı olarak kullanılır ancak REST istemcileri tarafından belirtilemez. REST istemcileri, packageName yerine Veri Kaynağı veri akışı kimliklerine geliştirici proje numarasını yansıtacaktır.
application.version	string	Uygulamanın sürümü. Uygulama, verilerin hesaplanmasını etkileyecek şekilde değiştiğinde bu alanı güncellemeniz gerekir.
dataQualityStandard[]	list	BU ALANI DOLDURMAYIN. Platformdan gelen yanıtlarda hiçbir zaman doldurulmaz ve sorgularda yoksayılır. Gelecekteki bir sürümde tamamen kaldırılacaktır.
dataStreamId	string	Bu veri kaynağı tarafından oluşturulan veri akışı için benzersiz bir tanımlayıcı. Tanımlayıcı şunları içerir: Fiziksel cihazın üreticisi, modeli ve seri numarası (UID). Uygulamanın paket adı veya adı. Veri kaynağı bir Android uygulaması tarafından oluşturulduğunda paket adı kullanılır. Geliştirici proje numarası, veri kaynağı bir REST istemcisi tarafından oluşturulduğunda kullanılır. Veri kaynağı türü. Veri kaynağının akış adı. Veri tanımlayıcısının bir parçası olarak veri kaynağının tüm özelliklerinin kullanılmadığını unutmayın. Özellikle donanımın/uygulamanın sürümü kullanılmaz. Bu sayede, sürüm güncellemeleri aracılığıyla aynı yayını koruyabiliriz. Bu, iki DataSource nesnesinin eşit olmasa bile aynı veri akışını temsil edebileceği anlamına da gelir. Bir Android uygulaması tarafından oluşturulan veri akışı kimliğinin tam biçimi şöyledir: type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName REST istemcisi tarafından oluşturulan veri akışı kimliğinin tam biçimi şu şekildedir: type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName Veri akışı kimliğini oluşturan isteğe bağlı alanlardan herhangi biri eksik olduğunda, bu veriler veri akışı kimliğinden çıkarılır. Minimum uygulanabilir veri akışı kimliği şöyle olmalıdır: type:dataType.name:developer proje numarası Son olarak, veri kaynağını oluşturmamış herhangi bir REST veya Android istemcisi tarafından okunduğunda geliştirici proje numarası ve cihaz UID'si karartılır. Geliştirici proje numarasını yalnızca veri kaynağı oluşturucu, net ve normal biçimde görür. Bu durumda bir istemci, farklı kimlik bilgilerine sahip başka bir istemciden farklı bir data_stream_ids grubu görür.
dataStreamName	string	Akış adı, aynı veri kaynağını aynı temel yapımcıdan gelen, aynı türdeki diğer veri kaynakları arasında benzersiz olarak tanımlar. Akış adını ayarlamak isteğe bağlıdır ancak bir uygulama aynı veri türü için iki akış gösterdiğinde veya cihazda iki eşdeğer sensör olduğunda yapılmalıdır.
dataType	nested object	Veri türü, Fitness API'sı tarafından toplanan, eklenen veya sorgulanan veri akışı için şemayı tanımlar.
dataType.field[]	list	Bir alan, veri türünün bir boyutunu temsil eder.
dataType.field[].format	string	Veri türündeki her alan için desteklenen farklı biçimler. Kabul edilebilir değerler şunlardır: "blob" "floatList" "floatPoint" "integer" "integerList" "map" "string"
dataType.field[].name	string	Verilerin adını ve biçimini tanımlar. Veri türü adlarının aksine, alan adları adlandırılmış değildir ve yalnızca veri türü içinde benzersiz olmalıdır.
dataType.field[].optional	boolean
dataType.name	string	Her veri türünün benzersiz ve adlandırılmış bir adı vardır. com.google ad alanındaki tüm veri türleri, platformun parçası olarak paylaşılır.
device	nested object	Sensörleri tutabilen entegre bir cihazın (telefon veya giyilebilir cihaz gibi) temsili.
device.manufacturer	string	Ürünün/donanımın üreticisi.
device.model	string	Cihazın son kullanıcı tarafından görülebilen model adı.
device.type	string	Cihazın türünü temsil eden bir sabit değer. Kabul edilebilir değerler şunlardır: "chestStrap" "headMounted" "phone" "scale" "smartDisplay" "tablet" "unknown" "watch"
device.uid	string	Donanımın seri numarası veya diğer benzersiz kimliği. Bu alan, veri kaynağını oluşturmamış herhangi bir REST veya Android istemcisi tarafından okunduğunda karartılır. Yalnızca ve diğer veri kaynağı oluşturanlar, uid alanını net ve normal biçimde görür. Karartma, eşitliği korur. Yani kimliği 1 == id2, kodu karartılmış(id1) == kodu karartılmış(id2) ise iki kimlik verilir.
device.version	string	Cihaz donanımının/yazılımının sürüm dizesi.
name	string	Bu veri kaynağı için görünür, son kullanıcı.
type	string	Bu veri kaynağının türünü tanımlayan sabit değer. Bu veri kaynağının ham veya üretilmiş verileri üretip üretmediğini belirtir. Kabul edilebilir değerler şunlardır: "derived" "raw"

Yöntemler

oluştur

Bu kullanıcıya ait tüm veri kaynakları genelinde benzersiz olan yeni bir veri kaynağı oluşturur.

Veri kaynağı, sensör verilerinin benzersiz bir kaynağıdır. Veri kaynakları, yerel veya tamamlayıcı cihazlardaki donanım sensörlerinden gelen ham verileri gösterebilir. Ayrıca, diğer veri kaynaklarını dönüştürerek veya birleştirerek türetilen verileri de gösterebilir. Aynı veri türü için birden çok veri kaynağı olabilir. Fitness API'sine eklenen veya okunan her veri kümesindeki her veri noktasının ilişkili bir veri kaynağı vardır.

Her veri kaynağı, benzersiz bir veri kaynağı tanımlayıcısıyla veri kümesi güncellemelerinden oluşan benzersiz bir akış üretir. Veri kaynağında yapılan tüm değişiklikler veri akışı kimliğini etkilemez. Bu nedenle, aynı uygulamanın/cihazın güncellenmiş sürümleri tarafından toplanan veriler aynı veri kaynağına ait olmaya devam edebilir.

Veri kaynakları, oluşturulan kaynağın içeriğine göre sunucu tarafından oluşturulan bir dize kullanılarak tanımlanır. Bu yöntem çağrılırken dataStreamId alanı ayarlanmamalıdır. Doğru biçimdeki sunucu tarafından otomatik olarak oluşturulur. Bir dataStreamId ayarlanırsa sunucu tarafından oluşturulacak biçimle eşleşmelidir. Bu biçim, veri kaynağındaki bazı alanların bir kombinasyonudur ve belirli bir sırasına sahiptir. Eşleşmezse istek bir hata nedeniyle başarısız olur.

Bilinen bir veri türü olmayan bir DataType belirtildiğinde (""com.google.&quot" ile başlar) özel veri türü içeren bir DataSource oluşturulur. Özel veri türleri yalnızca bunları oluşturan uygulama tarafından okunabilir. Özel veri türleri kullanımdan kaldırıldı; bunun yerine standart veri türlerini kullanın.

Veri kaynağı kimliğine dahil olan veri kaynağı alanlarının yanı sıra, veri kaynağı oluşturulurken kimliği doğrulanan geliştirici projesi numarası dahil edilir. Bu geliştirici projesi numarası, herkese açık veri türlerini okuyan diğer geliştiriciler tarafından okunduğunda karartılır.

sil

Belirtilen veri kaynağını siler. Veri kaynağında veri noktaları varsa istek başarısız olur.

al

Belirtilen veri kaynağını döndürür.

list

Sağlanan OAuth kapsamlarını kullanarak geliştirici tarafından görülebilen tüm veri kaynaklarını listeler. Bu listede olası her örneğe yer verilmemiştir. Kullanıcının yalnızca diğer geliştiriciler tarafından görülebilen özel veri kaynakları veya diğer kapsamları kullanan aramalar olabilir.

güncelle

Belirtilen veri kaynağını günceller. version hariç dataStreamId, dataType, type, dataStreamName ve device özellikleri değiştirilemez.

Veri kaynakları dataStreamId aracılığıyla tanımlanır.