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."" 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:
|
|
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:
|
|
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:
|
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.