Users.dataSources: update

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

Veri kaynakları dataStreamId aracılığıyla 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 gereklidir:

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ını inceleyin.

İstek metni

İ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ında bilgi.
application.name string Bu uygulamanın adı. Bu, REST müşterileri için gereklidir, ancak bu adın benzersizliğini zorunlu kılmayız. Hangi REST'in Uygulama veya Veri Kaynağı oluşturduğunu belirlemek isteyen diğer geliştiricilere kolaylık sağlamak amacıyla sunulmaktadı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ğı bir REST istemcisi tarafından oluşturulduğunda kullanılır.
  • Veri kaynağı türü.
  • Veri kaynağının akış adı.
Veri tanımlayıcısının bir parçası olarak veri kaynağının tüm özelliklerinin kullanılmadığını unutmayın. Özellikle donanımın/uygulamanın sürümü kullanılmaz. Bu sayede, sürüm güncellemeleri aracılığıyla aynı yayını koruyabiliriz. Bu, iki DataSource nesnesinin eşit olmasa 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 şöyledir: 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 veriler veri akışı kimliğinden çıkarılır. Minimum uygulanabilir veri akışı kimliği şöyle olmalıdır: 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 karartılır. Geliştirici proje numarasını yalnızca veri kaynağı oluşturucu, net ve normal biçimde görür. Bu durumda bir istemci, farklı kimlik bilgilerine sahip başka bir istemciden farklı bir data_stream_ids grubu görür.
dataType nested object Veri türü, Fitness API'sı tarafından toplanan, eklenen veya sorgulanan veri akışı için şemayı tanımlar.
dataType.field[] list Bir alan, veri türünün bir boyutunu temsil eder.
dataType.field[].format string Veri türündeki her alan için desteklenen farklı biçimler.

Kabul edilebilir 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ının aksine, alan adları adlandırılmış değildir ve yalnızca veri türü içinde benzersiz olmalıdır.
dataType.name string Her veri türünün benzersiz ve adlandırılmış bir adı vardır. com.google ad alanındaki tüm veri türleri, platformun parçası olarak paylaşılır.
device nested object Sensörleri tutabilen entegre bir cihazın (telefon veya giyilebilir cihaz gibi) temsili.
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 bir sabit değer.

Kabul edilebilir 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ği. Bu alan, veri kaynağını oluşturmamış herhangi bir REST veya Android istemcisi tarafından okunduğunda karartılır. Yalnızca ve diğer veri kaynağı oluşturanlar, uid alanını net ve normal biçimde görür.

Karartma, eşitliği korur. Yani kimliği 1== id2, kodu karartılmış(id1) == kodu karartılmış(id2) ise iki kimlik verilir.
device.version string Cihaz donanımının/yazılımının sürüm dizesi.
type string Bu veri kaynağının türünü tanımlayan sabit değer. Bu veri kaynağının ham veya üretilmiş verileri üretip üretmediğini belirtir.

Kabul edilebilir 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.