Users.dataSources: create

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. 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. Kimliği doğrulanmış kullanıcıyı belirtmek için me kullanın. Şu anda yalnızca me desteklenmektedir.

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az biriyle yetkilendirme gerekiyor:

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 için kimlik doğrulama ve yetkilendirme sayfasına bakı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 Sensör verilerini platforma besleyen bir uygulama hakkındaki bilgiler.
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.
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.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.
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"

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.