Users.dataSources: update

Belirtilen veri kaynağını günceller. version hariç dataStreamId, dataType, type, dataStreamName ve device özellikleri değiştirilemez.

Veri kaynakları dataStreamId ile tanımlanır. Hemen deneyin.

İstek

HTTP isteği

PUT https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId

Parametreler

Parametre adı Değer Açıklama
Yol parametreleri
dataSourceId string Güncellenecek veri kaynağının veri akışı kimliği.
userId string Tanımlanan kişinin veri kaynağını güncelleyin. Kimliği doğrulanmış kullanıcıyı belirtmek için me kullanın. Şu anda yalnızca me desteklenmektedir.

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az biriyle yetkilendirme gerekiyor:

Kapsam
https://www.googleapis.com/auth/fitness.activity.write
https://www.googleapis.com/auth/fitness.location.write
https://www.googleapis.com/auth/fitness.body.write
https://www.googleapis.com/auth/fitness.nutrition.write
https://www.googleapis.com/auth/fitness.blood_pressure.write
https://www.googleapis.com/auth/fitness.blood_glucose.write
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
https://www.googleapis.com/auth/fitness.body_temperature.write
https://www.googleapis.com/auth/fitness.reproductive_health.write

Daha fazla bilgi için kimlik doğrulama ve yetkilendirme sayfasına bakın.

İstek içeriği

İstek gövdesinde, aşağıdaki özelliklere sahip bir Users.dataSources kaynağı sağlayın:

Mülk adı Değer Açıklama Notlar
Zorunlu Özellikler
application nested object Sensör verilerini platforma besleyen bir uygulama hakkındaki bilgiler.
application.name string Bu uygulamanın adı. Bu, REST müşterileri için gereklidir ancak bu adın benzersiz olmasını zorunlu kılmayız. Bu, hangi REST'in bir Uygulama veya Veri Kaynağı oluşturduğunu belirlemek isteyen diğer geliştiricilere kolaylık sağlamak amacıyla sağlanmıştır.
dataStreamId string Bu veri kaynağı tarafından oluşturulan veri akışının benzersiz tanımlayıcısı. Tanımlayıcı şunları içerir:

  • Fiziksel cihazın üreticisi, modeli ve seri numarası (UID).
  • Uygulamanın paket adı veya adı. Veri kaynağı bir Android uygulaması tarafından oluşturulduğunda paket adı kullanılır. Veri kaynağı bir REST istemcisi tarafından oluşturulduğunda geliştirici proje numarası kullanılır.
  • Veri kaynağının türü.
  • Veri kaynağının akış adı.
Veri kaynağının tüm özelliklerinin, akış kimliğinin bir parçası olarak kullanılmadığını unutmayın. Özellikle, donanımın/uygulamanın sürümü kullanılmaz. Bu, sürüm güncellemeleri aracılığıyla aynı akışı korumamıza olanak tanır. Bu, iki DataSource nesnesinin eşit olmasalar bile aynı veri akışını temsil edebileceği anlamına da gelir.

Bir Android uygulaması tarafından oluşturulan veri akışı kimliğinin tam biçimi şu şekildedir: type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName

REST istemcisi tarafından oluşturulan veri akışı kimliğinin tam biçimi şu şekildedir: type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName

Veri akışı kimliğini oluşturan isteğe bağlı alanlardan herhangi biri eksik olduğunda bu alanlar veri akışı kimliğinden çıkarılır. Minimum uygulanabilir veri akışı kimliği şöyle olur: type:dataType.name:developer proje numarası

Son olarak, veri kaynağını oluşturmamış herhangi bir REST veya Android istemcisi tarafından okunduğunda geliştirici proje numarası ve cihaz UID'si kod karartılır. Geliştirici proje numarasını yalnızca veri kaynağını oluşturan kişi açık ve normal biçimde görür. Bu durum, bir istemcinin farklı kimlik bilgilerine sahip başka bir istemciden farklı bir data_stream_id grubu göreceği anlamına gelir.

dataType nested object Veri türü, Fitness API tarafından toplanan, eklenen veya Fitness API'den sorgulanan veri akışının şemasını tanımlar.
dataType.field[] list Alan, bir veri türünün bir boyutunu temsil eder.
dataType.field[].format string Bir veri türündeki her alan için desteklenen farklı biçimler.

Kabul edilen değerler şunlardır:
  • "blob"
  • "floatList"
  • "floatPoint"
  • "integer"
  • "integerList"
  • "map"
  • "string"
dataType.field[].name string Verilerin adını ve biçimini tanımlar. Veri türü adlarından farklı olarak, alan adları ad alanlı değildir ve yalnızca veri türü dahilinde benzersiz olmaları gerekir.
dataType.name string Her veri türünün benzersiz, ad alanına sahip bir adı vardır. com.google ad alanındaki tüm veri türleri, platform kapsamında paylaşılır.
device nested object Sensörleri tutabilen entegre bir cihazın (ör. telefon veya giyilebilir cihaz) gösterimi.
device.manufacturer string Ürünün/donanım üreticisinin üreticisi.
device.model string Cihazın son kullanıcı tarafından görülebilen model adı.
device.type string Cihazın türünü temsil eden sabit bir değerdir.

Kabul edilen değerler şunlardır:
  • "chestStrap"
  • "headMounted"
  • "phone"
  • "scale"
  • "smartDisplay"
  • "tablet"
  • "unknown"
  • "watch"
device.uid string Donanıma ait seri numarası veya başka bir benzersiz kimlik. Bu alan, veri kaynağını oluşturmamış herhangi bir REST veya Android istemcisi tarafından okunduğunda karartılır. UID alanını yalnızca veri kaynağını oluşturan kişi açık ve normal biçimde görür.

Kod karartma işlemi eşitliği korur. Bu durumda, id1 == id2 ise kod karartma(id1) == obfuscated(id2) şeklinde iki kimlik kullanılır.

device.version string Cihaz donanımı/yazılımının sürüm dizesi.
type string Bu veri kaynağının türünü açıklayan sabit değer. Bu veri kaynağının ham veri mi yoksa türetilmiş veri mi oluşturduğunu belirtir.

Kabul edilen değerler şunlardır:
  • "derived"
  • "raw"

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir Users.dataSources kaynağı döndürür.

Deneyin.

Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.