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:
Bir Android uygulaması tarafından oluşturulan veri akışı kimliğinin tam biçimi şöyledir: type:dataType.name REST istemcisi tarafından oluşturulan veri akışı kimliğinin tam biçimi şu şekildedir: type:dataType.name 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:
|
|
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:
|
|
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:
|
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ırkendataStreamId
alanı ayarlanmamalıdır. Doğru biçimdeki sunucu tarafından otomatik olarak oluşturulur. BirdataStreamId
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."" 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
vedevice
özellikleri değiştirilemez.
Veri kaynaklarıdataStreamId
aracılığıyla tanımlanır.