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 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 kullanıma sunabilirler. 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ğı, donanım cihazı ve verileri toplayan ve/veya dönüştüren uygulama da dahil olmak üzere, verilerini benzersiz bir şekilde tanımlamak için yeterli bilgi içerir. Ayrıca donanım ve uygulama sürümleri ile cihaz türü gibi yararlı meta verileri de saklar.

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ümlerinden toplanan veriler aynı veri akışına ait olarak kabul edilebilir.

Bu kaynağa yönelik yöntem 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 Platforma sensör verilerini besleyen bir uygulama hakkında bilgi.
application.detailsUrl string Tekrar uygulamaya bağlantı vermek 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ı zorunlu değildir. Bu bilgi, 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 uygulamanın paket adı. Bu ad, Android uygulamaları tarafından oluşturulduğunda benzersiz bir tanımlayıcı olarak kullanılır ancak REST istemcileri tarafından belirtilemez. REST istemcilerinin geliştirici proje numaraları, packageName yerine Veri Kaynağı veri akışı kimliklerine yansıtılır.
application.version string Uygulamanın sürümü. Uygulama, verilerin hesaplamasını etkileyecek şekilde her değişiklik yaptığı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ışı 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ğı REST istemcisi tarafından oluşturulduğunda kullanılır.
  • Veri kaynağının türü.
  • Veri kaynağının akış adı.
Veri kaynağının bazı özelliklerinin akış tanımlayıcısının bir parçası olarak kullanılmadığını unutmayın. Özellikle, donanımın/uygulamanın sürümü kullanılmaz. Bu sayede sürüm güncellemeleriyle aynı akışı koruyabiliriz. Bu aynı zamanda, iki DataSource nesnesinin eşit olmasa bile aynı veri akışını temsil edebileceği anlamına gelir.

Bir Android uygulaması tarafından oluşturulan veri akışı kimliğinin tam biçimi şu şekildedir: type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName

Bir 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 eksikse bunlar veri akışı kimliğinden çıkarılır. Minimum uygulanabilir veri akışı kimliği şöyle olur: type:dataType.name:developer project number

Son olarak da geliştirici proje numarası ve cihaz UID'si, veri kaynağını oluşturmamış herhangi bir REST veya Android istemcisi tarafından okunduğunda kodu 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_ids kümesi göreceği anlamına gelir.

dataStreamName string Akış adı, bu özel 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ışı şemasını tanımlar.
dataType.field[] list Alan, 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:
  • "blob"
  • "floatList"
  • "floatPoint"
  • "integer"
  • "integerList"
  • "map"
  • "string"
dataType.field[].name string Verilerin adını ve biçimini tanımlar. Veri türü adlarından farklı olarak, alan adları ad alanına tabi 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 bir ad alanı vardır. com.google ad alanındaki tüm veri türleri, platformun bir parçası olarak 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ı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 sabit değer.

Kabul edilen 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ğidir. Bu alan, veri kaynağını oluşturmayan herhangi bir REST veya Android istemcisi tarafından okunduğunda kodu karartılır. Kullanıcı kimliği alanını yalnızca veri kaynağını oluşturan kişi açık ve normal biçimde görür.

Kod karartma eşitliği korur; yani iki kimlik verildiğinde, id1 == id2, obfuscated(id1) == obfuscated(id2) ifadesi kullanılır.

device.version string Cihaz donanımı/yazılımı için sürüm dizesi.
name string Bu veri kaynağı için son kullanıcı tarafından görülebilen ad.
type string Bu veri kaynağının türünü açıklayan sabit değer. Bu veri kaynağının ham veya türetilmiş veri üretip üretmediğini belirtir.

Kabul edilen değerler şunlardır:
  • "derived"
  • "raw"

Yöntemler

oluştur
Ait olan tüm veri kaynaklarında benzersiz olan yeni bir veri kaynağı oluşturur bu kullanıcıya.

Veri kaynağı, sensör verileri için benzersiz bir kaynaktır. Veri kaynakları Yerel veya tamamlayıcı cihazlardaki donanım sensörlerinden gelen ham veriler. Onlar Ayrıca, diğer verilerin dönüştürülmesi veya birleştirilmesiyle oluşturulan, türetilmiş verileri de açığa çıkarabilir kaynaklar. Aynı veri türü için birden fazla veri kaynağı olabilir. Her veri Fitness API'ye eklenen veya buradan okunan her veri kümesindeki noktanın bir ilişkilendirilmiş veri kaynağıdır.

Her veri kaynağı, benzersiz bir veri kümesi güncellemeleri akışı üretir ve benzersiz veri kaynağı tanımlayıcısı. Veri kaynağında yapılan tüm değişiklikler veri akışı kimliği olduğundan emin olun. Böylece veriler, uygulamanın/cihazın aynı verilere ait olduğu kabul edilebilir kaynak.

Veri kaynakları, sunucu tarafından oluşturulan bir dize kullanılarak, söz konusu e-posta adresini Google'a gönderebilirsiniz. dataStreamId alanı ayarlanmamalıdır. Google doğru biçimde, sunucu tarafından otomatik olarak oluşturulur. Eğer dataStreamId ayarlanmışsa oluşturacaktır. Bu biçim, ve bunların belirli bir sırası vardır. Eşleşmiyorsa istek bir hata ile başarısız olur.

Bilinen bir tür olmayan bir DataType belirtme ( "com.google."), özel veri türüne sahip bir Veri Kaynağı 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; standart veri türlerini kullanma .

Veri kaynağı kimliğine dahil edilen veri kaynağı alanlarına ek olarak veri oluşturulurken kimliği doğrulanan geliştirici projesi numarası kaynağı dahil edilir. Bu geliştirici projesi numarası okunurken gizleniyor herkese açık veri türlerini okuyan diğer geliştiriciler tarafından yapıldığını varsayalım.
sil
Belirtilen veri kaynağını siler. Veriler aşağıdaki gibiyse istek başarısız olur: kaynak kodu herhangi bir veri noktası içeriyor.
al
Belirtilen veri kaynağını döndürür.
list
OAuth kullanarak geliştiricinin görebildiği tüm veri kaynaklarını listeler kapsamdır. Bu listede olası her örneğe yer verilmemiştir. kullanıcı gizli kalmış olabilir veya yalnızca diğer geliştiricilerin görebildiği veri kaynakları veya diğer kapsamlarda.
güncelle
Belirtilen veri kaynağını günceller. dataStreamId, dataType, type, dataStreamName ve version hariç device mülk, değiştirilemez.

Veri kaynakları dataStreamId ile tanımlanır.