Google Fit REST API de dahil olmak üzere Google Fit API'lerinin desteği 2026'da sonlandırılacak. 1 Mayıs 2024 itibarıyla geliştiriciler bu API'leri kullanmak için kaydolamaz.

Bulut tabanlı entegrasyonlar için Google Health API'ye, adım takibi ve mobil öncelikli Android uygulamaları için ise Health Connect'e geçmenizi öneririz. Hangi API'ye veya platforma geçiş yapacağınızla ilgili talimatlar için Fit'e geçiş rehberini ziyaret edin.

Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Android'i kullanmaya başlama

Bu kılavuzda, Android'de Google Fit ile geliştirmeye nasıl başlayacağınız açıklanmaktadır.

Kurulum

Uygulamanızı oluşturmaya başlamadan önce aşağıdaki bölümlerde yer alan adımları tamamlayın.

Google Hesabı edinin

Google Fit API'lerini kullanmak için bir Google Hesabınız olmalıdır. Yeni bir hesap oluşturabilir veya mevcut bir hesabı kullanabilirsiniz. Uygulamanızı bir kullanıcının bakış açısından test etmek için ayrı bir hesap oluşturmak isteyebilirsiniz.

Google Play hizmetlerini edinin

Geliştirme ana makinenizde Google Play Hizmetleri için en son istemci kitaplığını edinin:

Android SDK Manager'ı açın.
SDK Tools (SDK Araçları) bölümünde Google Play Hizmetleri'ni bulun.
Bu paketlerin durumu Yüklendi değilse her ikisini de seçin ve Paketleri Yükle'yi tıklayın.

OAuth 2.0 istemci kimliği alma

Fitness API'yi etkinleştirmek için OAuth 2.0 istemci kimliği alın.

Projenizi oluşturma ve yapılandırma

Fitness API ile uygulama oluşturmak için Android Studio geliştirme ortamını kullanmanızı öneririz. Yeni bir proje oluşturma ve Android Studio'da yapılandırma hakkında ayrıntılı bilgi için Proje oluşturma başlıklı makaleyi inceleyin.

Google Play Hizmetleri istemci kitaplığını ekleme

Android Studio'da modülünüzün build.gradle dosyasını açın ve Google Play Hizmetleri istemci kitaplığını bağımlılık olarak ekleyin:

Kotlin DSL

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.3.0")
        implementation("com.google.android.gms:play-services-auth:22.0.0")
}

Groovy DSL

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.3.0'
    implementation 'com.google.android.gms:play-services-auth:22.0.0'
}

Bu sayede Gradle, uygulamanızı derlerken Fitness SDK'sını otomatik olarak indirir.

Uygulamanızı oluşturma ve test etme

Kurulum adımlarını tamamladıktan sonra uygulamanızı oluşturmaya başlayabilirsiniz. Başlamak için uygulamanızın depolayabileceği ve okuyabileceği veri türleri hakkında bilgi edinin. Google Fit'te verilerle çalışma hakkında daha fazla bilgi edinin.

Gerekli Android izinlerini alma

Bazı veri türlerini okuyup yazmak için uygulamanızın Android izinleri istemesi gerekir.

OAuth izinlerini alma

Uygulamanızın erişim iznine sahip olduğu veri türleri, yetkilendirme kapsamlarına karşılık gelir. Bu izinleri istemek için uygulamanızın hangi veri türlerine erişmesi gerektiğini bir FitnessOptions örneğine eklemeniz gerekir. Uygulamanız Google Fit veri türlerinden herhangi birini kullanmak istediğinde Android SDK, bu veri türlerinin hangi kapsamlara ait olduğunu otomatik olarak kontrol eder ve kullanıcıdan bu kapsamlar için yetkilendirme ister.

API istemcisi oluşturma

Bir API istemcisi oluşturun ve uygulamanızın veri yazmak veya okumak için erişmesi gereken veri türlerini ekleyin. Aşağıdaki uç noktalar kullanılabilir:

SensorsClient: Yerel cihazdaki ve yardımcı cihazlardaki donanım sensörlerinden farklı sağlık ve sağlıklı yaşam verisi kaynaklarına erişin.
RecordingClient: Sensör verilerinin düşük güçte, her zaman açık arka planda toplanması için kullanılır.
HistoryClient: Google Fit'e geçmiş verileri ekleme, silme ve okuma.
SessionsClient: Kullanıcı etkinliği oturumları oluşturma ve yönetme
GoalsClient: Kullanıcıların Google Fit'te oluşturduğu Kardiyo Puanı ve adım hedeflerini okuma.
ConfigClient: Google Fit platformundaki özel veri türlerine ve ayarlara erişme.

Fitness API istemcisinin nasıl oluşturulacağına dair bir örneği inceleyin.

Sonuçta ortaya çıkan kullanıcı yetkilendirme akışı

Aşağıda, kullanıcılardan izin istendiğinde karşılaştıkları yetkilendirme akışı gösterilmektedir:

**Şekil 1.**Kullanıcılar için yetkilendirme akışı.

Android izinleri: Kullanıcılar, uygulamanızı indirmeden önce uygulamanızın hangi Android izinlerini istediğini görür. Uygulamanız indirildikten sonra ihtiyaç duyduğu çalışma zamanında istenen izinleri ister ve kullanıcılar bu izinleri verir veya reddeder.
Uygulama Kontrolü ve bağlanma: Uygulamanız, diğer veri türlerine erişim istemeden önce izinlerin verilip verilmediğini kontrol eder.
OAuth kapsamları isteği: Google istemi, kullanıcının uygulamanıza erişmek istediği veri türleri için gereken OAuth kapsamlarını vermesini ister.
Erişim uygulandı: Kullanıcı izin verdikten sonra uygulamanız, kullanıcının izin verdiği kapsamlara ait veri türlerine erişebilir.

Doğrulama başvurusu yapma

Uygulamanızı oluşturup test ettikten sonra doğrulama için başvurmanız gerekir. Hassas ve kısıtlanmış kapsamlar için farklı düzeylerde gerekçe sunmanız gerekir.