Users.dataSources

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: 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. Veri kaynağı bir REST istemcisi tarafından oluşturulduğunda geliştirici proje numarası kullanılır. Veri kaynağının türü. Veri kaynağının akış adı. Veri kaynağının tüm özelliklerinin, akış kimliğinin bir parçası olarak kullanılmadığını unutmayın. Özellikle, donanımın/uygulamanın sürümü kullanılmaz. Bu, sürüm güncellemeleri aracılığıyla aynı akışı korumamıza olanak tanır. Bu, iki DataSource nesnesinin eşit olmasalar 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 şu şekildedir: 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 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: "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 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: "chestStrap" "headMounted" "phone" "scale" "smartDisplay" "tablet" "unknown" "watch"
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: "derived" "raw"

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ırken dataStreamId 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 ve device özellikleri değiştirilemez.

Veri kaynakları dataStreamId ile tanımlanır.