Users.dataSources: update

Belirtilen veri kaynağını günceller. dataStreamId, dataType, type, dataStreamName ve version hariç device mülk, 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. Şunlar için me kullanın: kimliği doğrulanmış kullanıcıyı belirtir. Burada yalnızca me destekleniyor gerekir.

Yetkilendirme

Bu istek, aşağıdaki kapsamların en az biriyle yetkilendirme gerektiriyor:

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 edinmek için kimlik doğrulama ve yetkilendirme sayfasına göz atı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 Platforma sensör verilerini besleyen bir uygulama hakkında bilgi.
application.name string Bu uygulamanın adı. Bu, REST müşterileri için gereklidir ancak bu adın benzersiz olması zorunlu değildir. Bu bilgi, 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ışı için benzersiz bir tanımlayıcı. 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. Geliştirici proje numarası, veri kaynağı REST istemcisi tarafından oluşturulduğunda kullanılır.
  • Veri kaynağının türü.
  • Veri kaynağının akış adı.
Veri kaynağının bazı özelliklerinin akış tanımlayıcısının bir parçası olarak kullanılmadığını unutmayın. Özellikle, donanımın/uygulamanın sürümü kullanılmaz. Bu sayede sürüm güncellemeleriyle aynı akışı koruyabiliriz. Bu aynı zamanda, iki DataSource nesnesinin eşit olmasa bile aynı veri akışını temsil edebileceği anlamına 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

Bir 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 eksikse bunlar veri akışı kimliğinden çıkarılır. Minimum uygulanabilir veri akışı kimliği şöyle olur: type:dataType.name:developer project number

Son olarak da geliştirici proje numarası ve cihaz UID'si, veri kaynağını oluşturmamış herhangi bir REST veya Android istemcisi tarafından okunduğunda kodu 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_ids kümesi 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ışı şemasını tanımlar.
dataType.field[] list Alan, 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 alanına tabi değildir ve yalnızca veri türü içinde benzersiz olmalıdır.
dataType.name string Her veri türünün benzersiz bir ad alanı vardır. com.google ad alanındaki tüm veri türleri, platformun bir parçası olarak 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ın ü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 değer.

Kabul edilen değerler şunlardır:
  • "chestStrap"
  • "headMounted"
  • "phone"
  • "scale"
  • "smartDisplay"
  • "tablet"
  • "unknown"
  • "watch"
device.uid string Donanımın seri numarası veya diğer benzersiz kimliğidir. Bu alan, veri kaynağını oluşturmayan herhangi bir REST veya Android istemcisi tarafından okunduğunda kodu karartılır. Kullanıcı kimliği alanını yalnızca veri kaynağını oluşturan kişi açık ve normal biçimde görür.

Kod karartma eşitliği korur; yani iki kimlik verildiğinde, id1 == id2, obfuscated(id1) == obfuscated(id2) ifadesi kullanılır.

device.version string Cihaz donanımı/yazılımı için 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 veya türetilmiş veri üretip üretmediğini 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.