Fitbit Web API, geliştirici entegrasyonları için daha standart, tutarlı ve ölçeklenebilir bir temel sağlamak amacıyla iyileştirilip modernize edildi ve artık Google Health API olarak adlandırılıyor. Google Health API, eski Fitbit Web API'nin stratejik evrimini temsil eder ve Google'ın modern altyapısı üzerinde sıfırdan yeniden oluşturulmuştur.
Bu platform sayesinde geliştiriciler, Google Cloud geliştirici araçlarının tüm gücünden yararlanabilir ve kullanıcıların Google OAuth 2.0 üzerinden izinlerini yönetebileceği tanıdık ve kolaylaştırılmış bir yöntemden faydalanabilir.
Google Health API ile neler yapabilirsiniz?
- Birleştirilmiş tek bir doğru kaynak: Yeni "Mutabakatı Yapılmış Akış" özelliğimiz, birden fazla kaynaktan gelen çakışan veri noktalarını mutabakatını yapma gibi karmaşık bir görevi üstlenir. Bu sayede uygulamalar, kullanıcıların Fitbit uygulamasında gördüğü tutarlı verileri gösterir. Bu akış, Fitbit ve Pixel cihazlardan alınan verilerin yanı sıra manuel girişleri de içeren birinci taraf akışımıza ek olarak sağlanır.
- Teknik modernizasyon ve performans: 100'den fazla eski uç noktayı birleştirerek basitleştirilmiş veri türü paketlerinden oluşan akıcı bir set haline getirdik ve veri biçimleri, saat dilimleri, ölçü birimleri ve hata işleme konularındaki tutarsızlıkları ortadan kaldırdık. Ayrıca, yüksek performanslı veri alma için artık HTTP/REST protokolünü de destekliyoruz. Ayrıca, gün içi veriler ve webhook'lar artık özel bir liste uç noktası aracılığıyla tüm ilgili veri türleri için kullanılabilir.
- Gelişmiş webhook'lar ve ölçeklenebilirlik: Yeni nesil yapay zeka destekli sağlık uygulamalarıyla ölçeklenecek şekilde tasarlanmış, tüm alakalı veri türleri için otomatik abonelikler ve ayrıntılı yönetim dahil olmak üzere genişletilmiş webhook desteğinden yararlanın.
- Kimlik ve güvenlik süreçleri kolaylaştırıldı: Eski Fitbit yetkilendirmesi (FOT) yerine Google OAuth 2.0 kullanın. Bu sayede geliştiriciler, standart Google kimlik doğrulama kitaplıklarını kullanarak kod tabanlarını basitleştirebilir ve kullanıcılara izinlerini yönetmeleri için tanıdık, merkezi bir yöntem sunabilir. Tüm Google Health API kapsamları "Kısıtlanmış" olarak kategorize edilir. Bu nedenle, erişim için gizlilik ve güvenlik incelemesi gerekir.
Önerilen öğeleri beğendiniz mi? Hemen başlayın.
API sürümleri ve herkese açık beta kanalı
Google Health API, Google'ın API İyileştirme Önerileri (AIP'ler), özellikle de AIP-185: API sürümü oluşturma ve AIP-181: Kararlılık düzeyleri uyarınca kanal tabanlı sürüm oluşturma özelliğini kullanır. API, herkese açık iki kanalda kullanılabilir: kararlı v4 kanalı ve herkese açık beta v4beta kanalı. Google, standart destek kanalları aracılığıyla her iki kanalı da destekler.
Kararlı ve beta kanallarını karşılaştırma
AIP-185 uyarınca v4beta kanalı, kararlı v4 kanalının bir üst kümesi olarak işlev görür. Bu sürüm, tüm kararlı v4 işlevlerinin yanı sıra iş ortakları tarafından test edilen erken erişim veri türlerini, alanlarını ve yöntemlerini içerir.
Belgelerde, yalnızca beta kanalında kullanılabilen API öğeleri v4beta etiketini gösterir.
| Özellik | Kararlı kanal (v4) |
Herkese açık beta kanalı (v4beta) |
|---|---|---|
| REST temel URI'si | https://health.googleapis.com/v4 |
https://health.googleapis.com/v4beta |
| gRPC paketi | google.devicesandservices.health.v4 |
google.devicesandservices.health.v4beta |
| Referans belgeler | v4 REST ve v4 RPC | v4beta REST ve v4beta RPC |
| Kararlılık düzeyi | Üretime hazır ve AIP-180 geriye dönük uyumluluk kurallarına tabidir. | Kararsız önizleme, herhangi bir zamanda bildirimde bulunulmaksızın uyumsuz değişikliklere veya kaldırılmaya tabidir. |
| Kullanma amacı | Canlı, kullanıcılara yönelik üretim uygulamaları. | Erken test, prototip oluşturma, şema doğrulama ve geliştirici geri bildirimi. |
| Destek | Standart destek kanalları üzerinden desteklenir. | Hata raporları, sorun giderme ve tasarım geri bildirimleri için standart destek kanalları aracılığıyla desteklenir. |
v4beta kanalını kullanma
v4beta ile etiketlenmiş özellikleri keşfederken aşağıdaki yönergeleri uygulayın:
v4beta'i öncelikli olarak geliştirme, hazırlık ve üretim dışı test ortamlarında kullanın.v4betauç noktalarına veya yalnızca beta sürümünde olan veri türlerine bağlı üretim özelliklerinin kullanıma sunulması önerilmez.v4betaiçindeki şemalar, alan adları, uç nokta davranışları ve veri temsilleri uyarı yapılmadan değiştirilebilir. Beta özellikler ve veri türleri, doğrulama hedeflerini karşılamıyorsa tamamen kaldırılabilir.- Beta kanalındaki zarar veren değişikliklerin temel
v4entegrasyonunuzu kesintiye uğratmaması için deneyselv4betaistemci kodunu özellik bayraklarının veya ayrı modüllerin arkasında izole edin. - Nihai API tasarımını şekillendirmeye yardımcı olmak için standart destek kanallarımız üzerinden
v4betaile ilgili destek alın, sorunları bildirin ve uygulama geri bildirimlerinizi paylaşın.
v4beta'dan kararlı v4'e yükseltme
Yeni veri türleri ve özellikler, kararlı v4 kanalına geçmeden önce iş ortağı testlerini ve pazar doğrulamasını desteklemek için v4beta kanalına eklenir.
Google, beta özelliklerini v4 sürümüne yükseltmeden önce aşağıdaki ölçütlere göre değerlendirir:
- İş ortağı testi, veri modelinin, alan semantiğinin ve sorgu kalıplarının gerçek dünyadaki uygulama gereksinimlerini karşıladığını doğrular.
- Geliştirici geri bildirimleri ve tasarım incelemeleri tamamlandıktan sonra şema, AIP-180 geriye dönük uyumluluk garantileri kapsamında kilitlenmeye hazır hale gelir.
- Uçtan uca Data Pipelines, cihaz senkronizasyonu ve hizmet güvenilirliği, üretim kalitesi standartlarını karşılar.
- AIP-185 desteği sonlandırma kuralları uyarınca, beta testi sırasında desteği sonlandırılan alanlar veya davranışlar
v4sürümüne yükseltilmek yerine kaldırılır.
AIP-181, beta değerlendirmesi için yaklaşık 90 günlük genel bir kural sunsa da bir özelliğin v4beta sürümünden v4 sürümüne yükseltilmesi için gereken gerçek süre; özelliğin karmaşıklığına, donanım kullanılabilirliğine ve doğrulama geri bildirimlerine bağlıdır. Bazı özellikler daha erken kullanıma sunulabilir, bazıları ise daha uzun süre v4beta kapsamında kalabilir veya kullanımdan kaldırılabilir.
Bir veri türü veya özellik kararlı v4 kanalına yükseltildiğinde Google, bu yükseltmeyi Sürüm notları'nda duyurur. Bu noktada, entegrasyonu üretim kullanıcılarına yayınlamadan önce isteklerinizi https://health.googleapis.com/v4beta yerine https://health.googleapis.com/v4 olarak güncelleyin.
Fitbit Web API'ye ne olacak?
Eski Fitbit Web API'si aşağıdaki zaman çizelgesine göre kullanımdan kaldırıldı:
- 30 Eylül 2026 (Destek sonu): Fitbit Web API desteği sona erdi ve Google, hataları düzeltmeyi veya API desteği sağlamayı bıraktı.
- 2 Kasım 2026 (API'nin devre dışı bırakılması): Fitbit Web API ve Fitbit OAuth uç noktaları devre dışı bırakıldı ve artık çalışmıyor ya da Google Health kullanıcılarıyla veri senkronizasyonu yapmıyor. Bu uç noktalara yapılan istekler başarısız olur ve HTTP
410 Gonedurum kodu döndürür.
Eski Fitbit Web API'yi ve Fitbit Authorization'ı kullanan geliştiriciler, uygulamalarını ve kullanıcılarını Google Health API'ye ve Google OAuth 2.0'a taşımalıdır.
Başlamak için geçiş rehberine bakın.
Hangi cihazlar desteklenir?
Mevcut ve önceki tüm Fitbit cihazları ile Google Pixel Watch'lar, Google Health API aracılığıyla döndürülen verileri toplar. Kullanılabilir veri türü, cihazların desteklediği işlevlere bağlıdır.
Mevcut cihazların listesini Google Store'da bulabilirsiniz.
Nasıl geri bildirim gönderebilirim?
Geri bildiriminiz bizim için çok değerlidir. Düşüncelerinizi Destek sayfasında listelenen destek kanallarımız üzerinden paylaşabilirsiniz.
Bu API'lerin size iyi destek sunması için elimizden geleni yapmış olsak da Google Health API aktif olarak gelişmeye devam ediyor. Geri bildirimlerinize dayanarak, şu andan Mayıs ayının sonuna kadar değişiklikler yapabileceğimizi ve bu değişikliklerin sizin tarafınızda da güncellemeler gerektirebileceğini lütfen unutmayın.
Yol haritası
Aşağıda, 2026'da kullanıma sunulacak özelliklerin listesi verilmiştir.
2026 4. Çeyrek
Veri Türleri (okuma ve yazma)
- Ayrıntılı deri sıcaklığı
- Bazal Metabolizma Hızı
- Health Connect ile eşitliği sağlamak için veri türleri ekleyeceğiz. 2026'nın 4. çeyreğinde ve 2027'nin 1. çeyreğinde daha birçok Health Connect veri türünün ekleneceğini görebilirsiniz.
Özellikler
- Yeni veri türlerine erken erişim için herkese açık beta kanalı
- Webhook telemetrisini izlemek için istatistik uç noktası