Users.dataSources: create

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. Hemen deneyin.

İstek

HTTP isteği

POST https://www.googleapis.com/fitness/v1/users/userId/dataSources

Parametreler

Parametre adı Değer Açıklama
Yol parametreleri
userId string Tanımlanan kişi için veri kaynağını oluşturun. Şunlar için me kullanın: kimliği doğrulanmış kullanıcıyı belirtir. Burada yalnızca me destekleniyor gerekir.

Yetkilendirme

Bu istek, aşağıdaki kapsamların en az biriyle yetkilendirme gerektiriyor:

Kapsam
https://www.googleapis.com/auth/fitness.activity.write
https://www.googleapis.com/auth/fitness.location.write
https://www.googleapis.com/auth/fitness.body.write
https://www.googleapis.com/auth/fitness.nutrition.write
https://www.googleapis.com/auth/fitness.blood_pressure.write
https://www.googleapis.com/auth/fitness.blood_glucose.write
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
https://www.googleapis.com/auth/fitness.body_temperature.write
https://www.googleapis.com/auth/fitness.reproductive_health.write

Daha fazla bilgi edinmek için kimlik doğrulama ve yetkilendirme sayfasına göz atın.

İstek içeriği

İstek gövdesinde, aşağıdaki özelliklere sahip bir Users.dataSources kaynağı sağlayın:

Mülk adı Değer Açıklama Notlar
Zorunlu Özellikler
application nested object Platforma sensör verilerini besleyen bir uygulama hakkında bilgi.
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.
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.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.
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"

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir Users.dataSources kaynağı döndürür.

Deneyin!

Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.