Veri türleri

Google Fit, com.google ad alanının altında bir dizi sağlık ve sağlıklı yaşam veri 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ı, bir veri türünün alanlarının değerleri ve zaman damgası bilgilerinden 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 "com.google" ön ekine sahiptir. Ö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 bu kişi bunları yazdı.

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

Sağlık veri 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.
Toplu 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 bir an için 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ı belirledikten sonra History API ile geçmiş verileri ekleyebilir, okuyabilir veya silebilirsiniz.

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ıdan hangi kapsamlar için izin vermesi isteneceğini belirler. 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 kısıtlı olup olmadığını kontrol etmek için bu tabloyu kullanın (bu, uygulamanız için uygulamanız gereken doğrulama adımlarını belirler):

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 okuyabilir. 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 Tansiyon verilerini Google Fit platformuna 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 verileri yazma Kısıtlanmış
https://www.googleapis.com/auth/fitness.location.read Google Fit platformundan konum verilerini okuma 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 Oksijen doygunluğu verilerini Google Fit platformuna 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 platformundan 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 ya da nabız kapsamları eklemeniz veya okuma kapsamı eklemeniz gerektiğinde kullanıcılara 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. Artımlı yetkilendirme isteğinde bulunmayla ilgili yönergeleri uygulayın.

Uygulamanızın bu verileri neden/nasıl kullandığını anlayan kullanıcıların erişim izni verme olasılığı daha yüksektir:

  • Kullanıcıları kendilerinden sorulacağı konusunda uyaran veya bilgilendiren bir ekran eklemeyi düşünebilirsiniz. kapsam dışı görülür.
  • Kullanıcıların bilinçli bir karar vermesi için uygulamanızın bu kapsamlara/verilere neden erişim istediğini açıkça belirtin.

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