Benzersiz bir sensör verisi kaynağının tanımı. Veri kaynakları, yerel veya tamamlayıcı cihazlardaki donanım sensörlerinden gelen ham verileri açığa çıkarabilir. Ayrıca, diğer veri kaynaklarının dönüştürülmesi veya birleştirilmesiyle oluşturulan türetilmiş verileri de gösterebilir. Aynı veri türü için birden fazla veri kaynağı olabilir. Bu hizmete eklenen veya bu hizmetten okunan her veri noktasının ilişkili bir veri kaynağı vardır.
Veri kaynağında, verilerini benzersiz bir şekilde tanımlamak için yeterli bilgi bulunur. Bu bilgiler arasında donanım cihazı ve verileri toplayan ve/veya dönüştüren uygulama da yer alır. Ayrıca, donanım ve uygulama sürümleri ile cihaz türü gibi yararlı meta verileri de barındırır.
Her veri kaynağı, benzersiz bir tanımlayıcıya sahip benzersiz bir veri akışı üretir. Veri kaynağında yapılan tüm değişiklikler akış kimliğini etkilemez. Bu nedenle, aynı uygulamanın/cihazın güncellenmiş sürümleri tarafından toplanan veriler yine de aynı veri akışına ait olarak kabul edilebilir.
Bu kaynağa ilişkin 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ındaki bilgiler. | |
application.detailsUrl |
string |
Uygulamaya geri bağlantı oluşturmak 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 benzersiz olmasını zorunlu kılmayız. Bu, hangi REST'in bir Uygulama veya Veri Kaynağı oluşturduğunu belirlemek isteyen diğer geliştiricilere kolaylık sağlamak amacıyla sağlanmıştır. | |
application.packageName |
string |
Bu uygulama için paket adı. Bu, Android uygulamaları tarafından oluşturulan benzersiz bir tanımlayıcı olarak kullanılır, ancak REST istemcileri tarafından belirtilemez. REST istemcilerinin geliştirici proje numarası, packageName yerine Veri Kaynağı veri akışı kimliklerine yansıtılır. | |
application.version |
string |
Uygulamanın sürümü. Uygulamada verilerin hesaplamasını etkileyecek şekilde değişiklik yapıldığında 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ışının benzersiz tanımlayıcısı. Tanımlayıcı şunları içerir:
Bir Android uygulaması tarafından oluşturulan veri akışı kimliğinin tam biçimi şu şekildedir: 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 alanlar veri akışı kimliğinden çıkarılır. Minimum uygulanabilir veri akışı kimliği şöyle olur: 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 kod karartılır. Geliştirici proje numarasını yalnızca veri kaynağını oluşturan kişi açık ve normal biçimde görür. Bu durum, bir istemcinin farklı kimlik bilgilerine sahip başka bir istemciden farklı bir data_stream_id grubu göreceği anlamına gelir. |
|
dataStreamName |
string |
Akış adı, bu veri kaynağını aynı temel üreticiye ait aynı türdeki diğer veri kaynakları arasında benzersiz bir şekilde tanımlar. Akış adının ayarlanması isteğe bağlıdır ancak bir uygulama aynı veri türü için iki akış gösterdiğinde veya bir cihazda iki eşdeğer sensör olduğunda yapılmalıdır. | |
dataType |
nested object |
Veri türü, Fitness API tarafından toplanan, eklenen veya Fitness API'den sorgulanan veri akışının şemasını tanımlar. | |
dataType.field[] |
list |
Alan, bir veri türünün bir boyutunu temsil eder. | |
dataType.field[].format |
string |
Bir veri türündeki her alan için desteklenen farklı biçimler.
Kabul edilen değerler şunlardır:
|
|
dataType.field[].name |
string |
Verilerin adını ve biçimini tanımlar. Veri türü adlarından farklı olarak, alan adları ad alanlı değildir ve yalnızca veri türü dahilinde benzersiz olmaları gerekir. | |
dataType.field[].optional |
boolean |
||
dataType.name |
string |
Her veri türünün benzersiz, ad alanına sahip bir adı vardır. com.google ad alanındaki tüm veri türleri, platform kapsamında paylaşılır. | |
device |
nested object |
Sensörleri tutabilen entegre bir cihazın (ör. telefon veya giyilebilir cihaz) gösterimi. | |
device.manufacturer |
string |
Ürünün/donanım üreticisinin ü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 sabit bir değerdir.
Kabul edilen değerler şunlardır:
|
|
device.uid |
string |
Donanıma ait seri numarası veya başka bir benzersiz kimlik. Bu alan, veri kaynağını oluşturmamış herhangi bir REST veya Android istemcisi tarafından okunduğunda karartılır. UID alanını yalnızca veri kaynağını oluşturan kişi açık ve normal biçimde görür. Kod karartma işlemi eşitliği korur. Bu durumda, id1 == id2 ise kod karartma(id1) == obfuscated(id2) şeklinde iki kimlik kullanılır. |
|
device.version |
string |
Cihaz donanımı/yazılımının sürüm dizesi. | |
name |
string |
Bu veri kaynağı için son kullanıcının görebileceği bir ad. | |
type |
string |
Bu veri kaynağının türünü açıklayan sabit değer. Bu veri kaynağının ham veri mi yoksa türetilmiş veri mi oluşturduğunu belirtir.
Kabul edilen değerler şunlardır:
|
Yöntemler
- oluştur
- Bu kullanıcıya ait tüm veri kaynaklarında benzersiz olan yeni bir veri kaynağı oluşturur.
Veri kaynağı, benzersiz bir sensör verisi kaynağıdır. Veri kaynakları, yerel veya tamamlayıcı cihazlardaki donanım sensörlerinden gelen ham verileri açığa çıkarabilir. Ayrıca, diğer veri kaynaklarının dönüştürülmesi veya birleştirilmesiyle oluşturulan türetilmiş verileri de ortaya çıkarabilir. Aynı veri türü için birden fazla veri kaynağı olabilir. Fitness API'ye eklenen veya Fitness API'den okunan her veri kümesinde bulunan her veri noktası, ilişkili bir veri kaynağına sahiptir.
Her veri kaynağı, benzersiz bir veri kaynağı tanımlayıcısıyla benzersiz bir veri kümesi güncellemeleri akışı oluşturur. 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, yine de aynı veri kaynağına ait olarak kabul edilebilir.
Veri kaynakları, oluşturulmakta olan 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. Bu değer, sunucu tarafından doğru biçimde otomatik olarak oluşturulur.dataStreamId
ayarlanmışsa bu değer, sunucunun oluşturacağı biçimle eşleşmelidir. Bu biçim, veri kaynağındaki bazı alanların bir kombinasyonudur ve belirli bir sıraya sahiptir. Eşleşmezse istek bir hatayla başarısız olur.
Bilinen bir tür olmayan ("com.google." ile başlayan) bir DataType belirtmek, özel veri türüne sahip bir DataSource oluşturur. Özel veri türleri, yalnızca bunları oluşturan uygulama tarafından okunabilir. Özel veri türleri kullanımdan kaldırılmıştır. Bunun yerine standart veri türlerini kullanın.
Veri kaynağı kimliğine dahil edilen veri kaynağı alanlarının yanı sıra, veri kaynağını oluştururken kimliği doğrulanan geliştirici proje numarası da dahil edilir. Bu geliştirici proje numarası, herkese açık veri türlerini okuyan başka bir geliştirici tarafından okunurken karartılır. - sil
- Belirtilen veri kaynağını siler. Veri kaynağında herhangi bir veri noktası varsa istek başarısız olur.
- al
- Belirtilen veri kaynağını döndürür.
- list
- Sağlanan OAuth kapsamları kullanılarak geliştiricinin görebildiği tüm veri kaynaklarını listeler. Liste tam kapsamlı değildir. Kullanıcının yalnızca diğer geliştiriciler tarafından görülebilen gizli veri kaynakları veya başka kapsamları kullanan çağrılar olabilir.
- güncelle
- Belirtilen veri kaynağını günceller.
version
hariçdataStreamId
,dataType
,type
,dataStreamName
vedevice
özellikleri değiştirilemez.
Veri kaynaklarıdataStreamId
ile tanımlanır.