Bu API referansı, kaynak türüne göre düzenlenir. Her kaynak türünde bir veya daha fazla veri gösterimi ve bir ya da daha fazla yöntem bulunur.
Kaynak türleri
- Users.dataSources
- Users.dataSources.dataPointChanges
- Users.dataSources.Veri kümeleri
- Users.dataset
- Users.sessions
Kullanıcı.veriKaynakları
Users.dataSources Kaynak ayrıntıları için kaynak temsili sayfasına bakın.
Yöntem | HTTP isteği | Açıklama |
---|---|---|
Aksi belirtilmedikçe https://www.googleapis.com/fitness/v1/users göre URI'ler | ||
oluştur |
POST /userId/dataSources
|
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. |
sil |
DELETE /userId/dataSources/dataSourceId
|
Belirtilen veri kaynağını siler. Veri kaynağında veri noktaları varsa istek başarısız olur. |
al |
GET /userId/dataSources/dataSourceId
|
Belirtilen veri kaynağını döndürür. |
list |
GET /userId/dataSources
|
Sağlanan OAuth kapsamları kullanılarak geliştirici tarafından görülebilen tüm veri kaynakları listelenir. Bu listede olası her örneğe yer verilmemiştir. Kullanıcının yalnızca diğer geliştiriciler tarafından görülebilen özel veri kaynakları veya diğer kapsamları kullanan aramalar olabilir. |
güncelle |
PUT /userId/dataSources/dataSourceId
|
Belirtilen veri kaynağını günceller. version hariç dataStreamId ,
dataType , type , dataStreamName ve
device özellikleri değiştirilemez.
Veri kaynakları dataStreamId aracılığıyla tanımlanır.
|
Users.veriKaynakları.veriNokta Değişiklikleri
Users.dataSources.dataPointChanges Kaynak ayrıntıları için kaynak temsili sayfasına bakın.
Yöntem | HTTP isteği | Açıklama |
---|---|---|
Aksi belirtilmedikçe https://www.googleapis.com/fitness/v1/users göre URI'ler | ||
list |
GET /userId/dataSources/dataSourceId/dataPointChanges
|
Belirli bir veri kaynağıyla ilgili kullanıcı veri noktası değişiklikleri. |
Kullanıcı.veriKaynakları.veri kümeleri
Kullanıcı.veriKaynakları.veri kümeleriyle ilgili Kaynak ayrıntıları için kaynak temsili sayfasına bakın.
Yöntem | HTTP isteği | Açıklama |
---|---|---|
Aksi belirtilmedikçe https://www.googleapis.com/fitness/v1/users göre URI'ler | ||
sil |
DELETE /userId/dataSources/dataSourceId/datasets/datasetId
|
Başlangıç ve bitiş zamanları, veri kümesi kimliği tarafından belirtilen zaman aralığıyla çakışan tüm veri noktalarının kapsayıcı bir şekilde silme işlemini gerçekleştirir. Çoğu veri türünde veri noktasının tamamı silinir. Zaman aralığının tutarlı bir değeri (com.google.activity.segment gibi) temsil ettiği ve veri noktasının, veri kümesinin her iki ucunda da durduğu veri türlerinde yalnızca veri noktasının çakışan bölümü silinir.
|
al |
GET /userId/dataSources/dataSourceId/datasets/datasetId
|
Başlangıç ve bitiş zamanları, belirtilen veri kümesi minimum başlangıç zamanı ve maksimum bitiş zamanı aralığıyla çakışan tüm veri noktalarını içeren bir veri kümesini döndürür. Özellikle, başlangıç zamanı veri kümesinin bitiş zamanına eşit veya bundan kısa olan ve bitiş zamanı veri kümesinin başlangıç zamanına eşit veya bundan daha uzun olan tüm veri noktaları. |
yama |
PATCH /userId/dataSources/dataSourceId/datasets/datasetId
|
Veri kümesine veri noktaları ekler. Veri kümesinin önceden oluşturulması gerekmez.
Belirli bir veri kümesindeki tüm noktalar, bu veri kümesini almak için daha sonra yapılan çağrılarla birlikte döndürülür. Veri noktaları birden fazla veri kümesine ait olabilir.
Bu yöntem, yama semantiği kullanmaz: Sağlanan veri noktaları, değiştirilmeden yalnızca mevcut veriler değiştirilmez. |
Kullanıcı.veri kümesi
Users.dataset Kaynak ayrıntıları için kaynak temsili sayfasına bakın.
Yöntem | HTTP isteği | Açıklama |
---|---|---|
Aksi belirtilmedikçe https://www.googleapis.com/fitness/v1/users göre URI'ler | ||
birleştirilmiş |
POST /userId/dataset:aggregate
|
Belirli bir türe veya akışa ait verileri, belirli bir sınır türüne bölerek paketler. Birden fazla türden ve birden fazla kaynaktan gelen veri kümeleri, istek başına tam olarak bir paket türünde toplanabilir. |
Kullanıcı.oturumları
Users.sessions Kaynak ayrıntıları için kaynak temsili sayfasına bakın.
Yöntem | HTTP isteği | Açıklama |
---|---|---|
Aksi belirtilmedikçe https://www.googleapis.com/fitness/v1/users göre URI'ler | ||
sil |
DELETE /userId/sessions/sessionId
|
Belirtilen oturum kimliği tarafından belirtilen bir oturumu siler. |
list |
GET /userId/sessions
|
Daha önce oluşturulan oturumları listeler. |
güncelle |
PUT /userId/sessions/sessionId
|
Belirli bir oturumu günceller veya ekler. |