Veri türleri

Google Fit, com.google ad alanı altında bir dizi sağlık ve sağlıklı yaşam verisi türü sağlar.

Veri türleri, veri noktaları içindeki değerlerin biçimini tanımlar. Veri noktası aşağıdakileri temsil edebilir:

  • Anlık okuma veya gözlem
  • Belirli bir zaman aralığına ait istatistiklerle toplam

Google Fit, anlık gözlemlere yönelik veri türlerini, toplu verilere yönelik veri türlerini tanımlar dışı verilerdir. Veri noktaları, veri türü ve zaman damgası bilgisinin alanlarına ait değerlerden oluşur. Anlık gözlemleri temsil eden noktalar arasında zaman damgası ve Birleştirilmiş veri türü, aralığın başlangıç zamanını da içerir.

Google Fit ayrıca yeni veri türleri tanımlamanıza da olanak tanır.

Veri türü grupları

Google Fit'te aşağıdaki veri türleri bulunur:

Herkese açık veri türleri
Platform tarafından sağlanan standart veri türleri şunlardır: "com.google" ön eki ile değiştirebilirsiniz. Örneğin, com.google.step_count.delta. Bu veri türleri, verilerin depolandığı fitness aktivitesi, uyku ve beslenme dahil sağlık ve sağlıklı yaşam verileri. Herhangi biri Bu veri türlerini okumak ve bunlara yazmak için ilgili izinleri isteyebilir. yalnızca uygulamanın okuyabildiği birkaç konum verisi türü veya bunları yazdı.

Daha fazla bilgi için aşağıdaki sayfaları inceleyin:

Sağlık verisi türleri
Platformun sağladığı, erişimi kısıtlanmış veri türleri potansiyel olarak hassas verilerdir. Daha fazla bilgi için Sağlık verileri bölümüne bakın yazın.
Birleştirilmiş veri türleri
Zamana veya saate göre toplanan sağlık ve sağlıklı yaşam bilgilerini okumak için kullanılan veri türleri etkinlik türü. Daha fazla bilgi için Birleştirilmiş veriler bölümüne bakın. yazın.
Gizli özel veri türleri
Belirli bir uygulamanın tanımladığı özel veri türleri. Yalnızca veri türü bu türdeki verileri okuyup yazabilir. Daha fazla bilgi için bkz. Özel veri türleri.

Veri türlerini kullanma

Android

Android'de veri türleri, DataType sınıfını kullanır. Veri türüyle Fitness API'lerini nasıl çağıracağınız, neyi yapmak istediğinize bağlıdır:

  • Veri kaydetmek için Recording API'yi kullanarak kaydetmek istediğiniz her veri türü için bir abonelik oluşturun.
  • Verileri okumak için History API'yi kullanarak okuma isteği gönderin isteği gönderin.
  • Geçmişteki verileri eklemek için History API'yi kullanarak şu işlemleri yapabilirsiniz: Her veri türü için bir ekleme isteği gönderin.
  • Oturum oluşturmak için Sessions API'yi kullanarak oturum ekleyin veya mevcut oturumları kaydedin oturum meta verileri ile birlikte çalışın.

Anlık kararlara yönelik veri noktaları oluşturmak DataType doğru biçime sahip değerler atayın. Aşağıdaki örnekte size yemek maddesini dize olarak, yemek türünü Field sınıf, besin içeriklerini eşleştirilmiş kayan noktalı değerler olarak göreceksiniz.

val nutritionSource = DataSource.Builder()
    .setDataType(DataType.TYPE_NUTRITION)
    ...
    .build()

val nutrients = mapOf(
    Field.NUTRIENT_TOTAL_FAT to 0.4f,
    Field.NUTRIENT_SODIUM to 1f,
    Field.NUTRIENT_POTASSIUM to 422f
)
val banana = DataPoint.builder(nutritionSource)
    .setTimestamp(now, TimeUnit.MILLISECONDS)
    .setField(Field.FIELD_FOOD_ITEM, "banana")
    .setField(Field.FIELD_MEAL_TYPE, Field.MEAL_TYPE_SNACK)
    .setField(Field.FIELD_NUTRIENTS, nutrients)
    .build()

Uygulamanızda veri noktalarını ayarladıktan sonra bu verileri ekleyebilir, okuyabilir veya silebilirsiniz History API ile geçmiş veriler.

REST

dataSources kaynağı, veri türünü içeriyor (ve alanlarının listesi). Aşağıdaki durumlarda bu veri türlerinden birini belirtebilirsiniz: veri kaynakları oluşturursunuz ve veri türünün adını ve alanlarının listesini edinebilirsiniz fitness mağazasından bir veri kaynağı aldığınızda

Örneğin, bir veri kaynağı temsili, veri türünü aşağıdaki gibi belirtir:

{
"dataStreamId": "exampleDataSourceId",
...
"dataType": {
  "name": "com.google.step_count.delta"
},
...
}

Yetkilendirme kapsamları

Yetkilendirme kapsamları, kullanıcının bir uygulamayı yetkilendirebileceği veri türü gruplarını kapsar. erişim. Bunlar, kullanıcıların bir uygulamanın ne tür verilere erişmek istediğini anlamalarına yardımcı olur. Aynı zamanda, onay kutusunu işaretleyin. Kullanıcılar bu izinleri, inceleyebilirsiniz.

OAuth kapsamları izin ekranı örneği
Şekil 2. OAuth kapsamları izin ekranı.

Uygulamanızı az sayıda kullanıcıyla test ettikten sonra, doğrulama isteğinde bulunmanız gereken kapsamları belirler. Bağlantı verilen veri türleri sayfalarını okuyun yukarıdaki adımları inceleyin.

Örneğin, uygulamanızın tansiyon yazısını okuyup yazması gerekiyorsa hem okuma hem yazma yaptığını beyan etmesi ve her iki kapsamı da istemesi gerekir. Eğer yalnızca tansiyon verilerini Google Fit platformuna yazmak, yalnızca yazma kapsamını isteyin.

Veri türlerini sorumlu bir şekilde seçin. Uygulamanız için her veri türünü istemeyin gerekebilir. Belirtilen türler, kullanıcıya hangi kapsamların istendiğini belirler sağlayabilir. Kullanıcılardan yararlanabilmek için yalnızca uygulamanızın ihtiyaç duyduğu veri türlerini daha yüksek olabilir. Kullanıcılar daha kolay, sınırlı ve açık bir şekilde müzakere tekniklerini konuşacağız.

Uygulamanızın erişmesi gereken kapsamların hassas veya hassas olup olmadığını kontrol etmek için bu tabloyu kullanın. (bu, doğrulama uygulamanız gereken adımlar):

Kapsam Açıklama Kategori
https://www.googleapis.com/auth/fitness.activity.read Google Fit platformundaki aktivite verilerini okuma. Kısıtlanmış
https://www.googleapis.com/auth/fitness.activity.write Aktivite verilerini Google Fit platformuna yazma Kısıtlanmış
https://www.googleapis.com/auth/fitness.blood_glucose.read Google Fit platformundaki kan şekeri verilerini okuma. Kısıtlanmış
https://www.googleapis.com/auth/fitness.blood_glucose.write Google Fit platformuna kan şekeri verilerini yazma. Kısıtlanmış
https://www.googleapis.com/auth/fitness.blood_pressure.read Google Fit platformundaki tansiyon verilerini okuyabilir. Kısıtlanmış
https://www.googleapis.com/auth/fitness.blood_pressure.write Google Fit platformuna tansiyon verilerini yazma. Kısıtlanmış
https://www.googleapis.com/auth/fitness.body.read Google Fit platformundan vücut ölçüm verilerini (boy, kilo, vücut yağ yüzdesi) okuyabilir. Kısıtlanmış
https://www.googleapis.com/auth/fitness.body.write Vücut ölçümü verilerini Google Fit platformuna yazma. Kısıtlanmış
https://www.googleapis.com/auth/fitness.body_temperature.read Google Fit platformundaki vücut sıcaklığı verilerini okuma. Kısıtlanmış
https://www.googleapis.com/auth/fitness.body_temperature.write Vücut sıcaklığı verilerini Google Fit platformuna yazma. Kısıtlanmış
https://www.googleapis.com/auth/fitness.heart_rate.read Google Fit platformundan nabız verilerini okuma. Kısıtlanmış
https://www.googleapis.com/auth/fitness.heart_rate.write Google Fit platformuna nabız verilerini yazma. Kısıtlanmış
https://www.googleapis.com/auth/fitness.location.read Google Fit platformundan konum verilerini okuyabilir. Kısıtlanmış
https://www.googleapis.com/auth/fitness.location.write Konum verilerini Google Fit platformuna yazma. Kısıtlanmış
https://www.googleapis.com/auth/fitness.nutrition.read Google Fit platformundaki beslenme verilerini okuma. Kısıtlanmış
https://www.googleapis.com/auth/fitness.nutrition.write Google Fit platformuna beslenme verilerini yazma. Kısıtlanmış
https://www.googleapis.com/auth/fitness.oxygen_saturation.read Google Fit platformundaki oksijen doygunluğu verilerini okuma. Kısıtlanmış
https://www.googleapis.com/auth/fitness.oxygen_saturation.write Google Fit platformuna oksijen doygunluğu verilerini yazma. Kısıtlanmış
https://www.googleapis.com/auth/fitness.reproductive_health.read Google Fit platformundan üreme sağlığı verilerini okuma. Kısıtlanmış
https://www.googleapis.com/auth/fitness.reproductive_health.write Üreme sistemi sağlığı verilerini Google Fit platformuna yazma. Kısıtlanmış
https://www.googleapis.com/auth/fitness.sleep.read Google Fit platformundaki uyku verilerini okuyabilir. Kısıtlanmış
https://www.googleapis.com/auth/fitness.sleep.write Uyku verilerini Google Fit platformuna yazma. Kısıtlanmış

Mevcut bir uygulamaya yeni kapsamlar ekleme

Yeni bir kapsam istemek üzere uygulamanızı güncellediğinizde (örneğin, uyku veya nabız kapsamları ya da okuma kapsamı ekleyin) Uygulamanız bu kapsamlara erişim izni istiyor ve veya erişimi reddedebilirsiniz.

En iyi uygulama, o anda kullanıcılardan kaynaklar için yetkilendirme istemektir en iyi uygulamaları anlatacağım. Ek bütçe isteğinde bulunma talimatlarını uygulayın. yetkilendirme başlıklı makaleyi inceleyin.

Kullanıcıların, uygulamanızın nedenini/nasıl yapıldığını anlarlarsa erişim verme olasılıkları artar aşağıdaki verileri kullanır:

  • Kullanıcıları kendilerinden sorulacağı konusunda uyaran veya bilgilendiren bir ekran eklemeyi düşünebilirsiniz. kapsam dışı görülür.
  • Uygulamanızın bu kapsamlara/verilere neden erişim istediğini net bir şekilde açıklayın. kullanıcılar bilinçli kararlar verebilir.

Android için uygulama izinleriyle ilgili en iyi uygulamalar hakkında daha fazla bilgi edinin.