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](https://developers-dot-devsite-v2-prod.appspot.com/static/fit/images/OAuth_scopes_example.png?authuser=0000&hl=tr)
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.