Users.dataSources: create

Bu kullanıcıya ait tüm veri kaynakları genelinde benzersiz olan yeni bir veri kaynağı oluşturur.

Veri kaynağı, sensör verilerinin benzersiz bir kaynağıdır. Veri kaynakları, yerel veya tamamlayıcı cihazlardaki donanım sensörlerinden gelen ham verileri gösterebilir. Ayrıca, diğer veri kaynaklarını dönüştürerek veya birleştirerek türetilen verileri de gösterebilir. Aynı veri türü için birden çok veri kaynağı olabilir. Fitness API'sine eklenen veya okunan her veri kümesindeki her veri noktasının ilişkili bir veri kaynağı vardır.

Her veri kaynağı, benzersiz bir veri kaynağı tanımlayıcısıyla veri kümesi güncellemelerinden oluşan benzersiz bir akış üretir. 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 aynı veri kaynağına ait olmaya devam edebilir.

Veri kaynakları, oluşturulan 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. Doğru biçimdeki sunucu tarafından otomatik olarak oluşturulur. Bir dataStreamId ayarlanırsa sunucu tarafından oluşturulacak biçimle eşleşmelidir. Bu biçim, veri kaynağındaki bazı alanların bir kombinasyonudur ve belirli bir sırasına sahiptir. Eşleşmezse istek bir hata nedeniyle başarısız olur.

Bilinen bir veri türü olmayan bir DataType belirtildiğinde (""com.google.&quot" ile başlar) özel veri türü içeren bir DataSource oluşturulur. Özel veri türleri yalnızca bunları oluşturan uygulama tarafından okunabilir. Özel veri türleri kullanımdan kaldırıldı; bunun yerine standart veri türlerini kullanın.

Veri kaynağı kimliğine dahil olan veri kaynağı alanlarının yanı sıra, veri kaynağı oluşturulurken kimliği doğrulanan geliştirici projesi numarası dahil edilir. Bu geliştirici projesi numarası, herkese açık veri türlerini okuyan diğer geliştiriciler tarafından okunduğunda 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 gereklidir:

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ını inceleyin.

İstek metni

İ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ında bilgi.
application.name string Bu uygulamanın adı. Bu, REST müşterileri için gereklidir, ancak bu adın benzersizliğini zorunlu kılmayız. Hangi REST'in Uygulama veya Veri Kaynağı oluşturduğunu belirlemek isteyen diğer geliştiricilere kolaylık sağlamak amacıyla sunulmaktadır.
dataType nested object Veri türü, Fitness API'sı tarafından toplanan, eklenen veya sorgulanan veri akışı için şemayı tanımlar.
dataType.field[] list Bir alan, veri türünün bir boyutunu temsil eder.
dataType.field[].format string Veri türündeki her alan için desteklenen farklı biçimler.

Kabul edilebilir 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ının aksine, alan adları adlandırılmış değildir ve yalnızca veri türü içinde benzersiz olmalıdır.
dataType.name string Her veri türünün benzersiz ve adlandırılmış bir adı vardır. com.google ad alanındaki tüm veri türleri, platformun parçası olarak paylaşılır.
device nested object Sensörleri tutabilen entegre bir cihazın (telefon veya giyilebilir cihaz gibi) temsili.
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 bir sabit değer.

Kabul edilebilir 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ği. Bu alan, veri kaynağını oluşturmamış herhangi bir REST veya Android istemcisi tarafından okunduğunda karartılır. Yalnızca ve diğer veri kaynağı oluşturanlar, uid alanını net ve normal biçimde görür.

Karartma, eşitliği korur. Yani kimliği 1 == id2, kodu karartılmış(id1) == kodu karartılmış(id2) ise iki kimlik verilir.
device.version string Cihaz donanımının/yazılımının sürüm dizesi.
type string Bu veri kaynağının türünü tanımlayan sabit değer. Bu veri kaynağının ham veya üretilmiş verileri üretip üretmediğini belirtir.

Kabul edilebilir 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.