API Reference

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

  1. Users.dataSources
  2. Users.dataSources.dataPointChanges
  3. Users.dataSources.Veri kümeleri
  4. Users.dataset
  5. 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.&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.
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.