API Reference

Bu API referansı, kaynak türüne göre düzenlenmiştir. Her kaynak türünün bir veya daha fazla veri gösterimi ve bir ya da daha fazla yöntemi vardır.

Kaynak türleri

  1. Users.dataSources
  2. Users.dataSources.dataPointChanges
  3. Users.dataSources.datasets
  4. Users.dataset
  5. Users.sessions

Users.dataSources

Users.dataSources Kaynak ayrıntıları için kaynak gösterimi sayfasına bakın.

Yöntem HTTP isteği Açıklama
Aksi belirtilmedikçe https://www.googleapis.com/fitness/v1/users ile ilgili URI'lar
oluştur POST  /userId/dataSources 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.
sil DELETE  /userId/dataSources/dataSourceId Belirtilen veri kaynağını siler. Veri kaynağında herhangi bir veri noktası 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ını kullanarak geliştiricinin görebildiği tüm veri kaynaklarını listeler. Liste tam kapsamlı değildir. Kullanıcının yalnızca diğer geliştiriciler tarafından görülebilen gizli veri kaynakları veya başka kapsamları kullanan çağrılar 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 ile tanımlanır.

Users.dataSources.dataPointChanges

Users.dataSources.dataPointChanges Kaynak ayrıntıları için kaynak gösterimi sayfasına bakın.

Yöntem HTTP isteği Açıklama
Aksi belirtilmedikçe https://www.googleapis.com/fitness/v1/users ile ilgili URI'lar
list GET  /userId/dataSources/dataSourceId/dataPointChanges Belirli bir veri kaynağı için kullanıcının veri noktasına yönelik sorgular değişir.

Users.dataSources.datasets

Users.dataSources.datasets 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 ile ilgili URI'lar
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ı kapsayıcı şekilde siler. Ç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 bir veri noktasının, veri kümesinin iki uç noktasından birinde yer aldığı veri türlerinde yalnızca veri noktasının çakışan kısmı silinir.
al GET  /userId/dataSources/dataSourceId/datasets/datasetId Başlangıç ve bitiş zamanları, 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ümesi döndürür. Özellikle, başlangıç zamanı veri kümesinin bitiş zamanından az veya ona eşit olan ve bitiş zamanı, veri kümesinin başlangıç zamanından büyük ya da ona eşit olan herhangi bir veri noktası.
yama PATCH  /userId/dataSources/dataSourceId/datasets/datasetId Veri kümesine veri noktaları ekler. Veri kümesinin önceden oluşturulmuş olması gerekmez. Belirtilen veri kümesindeki tüm noktalar, bu veri kümesini almak için yapılan sonraki çağrılarla 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ı, mevcut veriler değiştirilmeden yalnızca eklenir.

Users.dataset

Users.dataset Kaynak ayrıntıları için kaynak gösterimi sayfasına bakın.

Yöntem HTTP isteği Açıklama
Aksi belirtilmedikçe https://www.googleapis.com/fitness/v1/users ile ilgili URI'lar
birleştirilmiş POST  /userId/dataset:aggregate Belirli bir türdeki veya akıştaki verileri, belirli bir sınır türüne göre ayrılmış paketler hâlinde toplar. Birden çok türde ve birden fazla kaynaktan gelen veri kümeleri, istek başına tam olarak bir paket türünde toplanabilir.

Users.sessions

Users.sessions Kaynak ayrıntıları için kaynak gösterimi sayfasına bakın.

Yöntem HTTP isteği Açıklama
Aksi belirtilmedikçe https://www.googleapis.com/fitness/v1/users ile ilgili URI'lar
sil DELETE  /userId/sessions/sessionId Belirtilen oturum kimliği ile belirtilen bir oturumu siler.
list GET  /userId/sessions Önceden oluşturulan oturumları listeler.
güncelle PUT  /userId/sessions/sessionId Güncellemeler veya belirli bir oturum ekleme.