Google Health API hakkında

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. v4beta uç noktalarına veya yalnızca beta sürümünde olan veri türlerine bağlı üretim özelliklerinin kullanıma sunulması önerilmez.
  • v4beta iç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 v4 entegrasyonunuzu kesintiye uğratmaması için deneysel v4beta istemci 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 v4beta ile 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 v4 sü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 Gone durum 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ı