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

Hangi API'ye veya platforma geçeceğinizle ilgili talimatlar için Health Connect taşıma rehberini ziyaret edin. Health Connect'in Google Fit API'leri ve Fitbit Web API'leriyle karşılaştırması için Health Connect karşılaştırma kılavuzunu ziyaret edin.

Health Connect hakkında daha fazla bilgi edinin ve API ile entegrasyon hakkında bilgi edinin.

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ümlerdeki adımları tamamlayın.

Google Hesabı edinin

Google Fit API'lerini kullanmak için Google Hesabınızın olması gerekir. Yeni bir hesap oluşturabilir veya mevcut bir hesabı kullanabilirsiniz. Uygulamanızı kullanıcı perspektifinden 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 services (Google Play Hizmetleri) seçeneğini bulun.
Bu paketlerin durumu Yüklendi değilse her ikisini de seçip Paketleri Yükle'yi tıklayın.

OAuth 2.0 istemci kimliği edinme

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

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ı oluştururken 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 izni olan veri türleri, yetkilendirme kapsamlarına karşılık gelir. Bu izinleri istemek için uygulamanızın erişmesi gereken veri türlerini 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 verilere yazmak veya verileri 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 gelen farklı sağlık ve sağlıklı yaşam verileri kaynaklarına erişin.
RecordingClient: Sensör verilerinin düşük güçle, her zaman açık şekilde arka planda toplanması için.
HistoryClient: Google Fit'te geçmiş verileri ekleme, silme ve okuma.
SessionsClient: Kullanıcı etkinliğinin oturumlarını oluşturma ve yönetme.
GoalsClient: Kullanıcıların Google Fit'te oluşturduğu Kalp Puanı ve Adım hedeflerini okur.
ConfigClient: Google Fit platformundaki özel veri türlerine ve ayarlara erişin.

Fitness API istemcisi oluşturma örneğini inceleyin.

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

Aşağıda, kullanıcılardan izin istendiğinde ortaya çıkan 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 istediği Android izinlerini görür. Uygulamanız indirildikten sonra ihtiyaç duyduğu çalışma zamanı izinlerini ister ve kullanıcılar bu izinleri verir veya reddeder.
Kontrol etme ve bağlanma: Uygulamanız, diğer veri türlerine erişim isteğinde bulunmadan önce izinlerin verilip verilmediğini kontrol eder.
OAuth kapsamları isteği: Google, kullanıcıdan 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 kapsamlar dahilindeki 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.