Users.dataSources: update

تعمل على تعديل مصدر البيانات المحدَّد. لا يمكن تعديل السمات dataStreamId وdataType وtype وdataStreamName وdevice باستثناء version.

يتم تحديد مصادر البيانات من خلال dataStreamId. التجربة الآن

الطلب

طلب HTTP

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

المعلمات

اسم المعلَمة القيمة الوصف
مَعلمات المسار
dataSourceId string رقم تعريف مصدر البيانات لمصدر البيانات المطلوب تعديله.
userId string عدِّل مصدر البيانات للشخص المحدّد. استخدِم "me" للإشارة إلى المستخدم الذي تمت مصادقته. يمكن استخدام السمة me فقط في الوقت الحالي.

التفويض

يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية:

النطاق
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

للحصول على مزيد من المعلومات، يمكنك الاطلاع على صفحة المصادقة والتفويض.

نص الطلب

في نص الطلب، قدِّم موردUsers.dataSources بالسمات التالية:

اسم الموقع القيمة الوصف Notes
الخصائص المطلوبة
application nested object معلومات حول التطبيق الذي يمد بيانات أداة الاستشعار إلى النظام الأساسي.
application.name string اسم هذا التطبيق. هذا الإجراء مطلوب لعملاء REST، ولكننا لا نفرض استخدامًا فريدًا لهذا الاسم. يتم توفير هذه المعلومات تيسيرًا للمطوّرين الآخرين الذين يريدون تحديد REST التي أنشأت تطبيقًا أو مصدر بيانات.
dataStreamId string معرّف فريد لمصدر البيانات الذي ينشئه مصدر البيانات هذا. يتضمّن المعرّف ما يلي:

  • تشير هذه السمة إلى الشركة المصنّعة للجهاز وطرازه ورقمه التسلسلي (UID).
  • اسم حزمة التطبيق أو اسمها يُستخدَم اسم الحزمة عندما أنشأ تطبيق Android مصدر البيانات. يتم استخدام رقم مشروع المطوّر عند إنشاء مصدر البيانات من قِبل عميل REST.
  • نوع مصدر البيانات.
  • اسم مصدر البيانات لمصدر البيانات.
يُرجى العلم بأنّه لا تُستخدَم بعض سمات مصدر البيانات كجزء من معرّف مصدر البيانات. وعلى وجه الخصوص، لا يتم استخدام إصدار الجهاز/التطبيق. يتيح لنا ذلك الحفاظ على البث نفسه من خلال تحديثات الإصدار. وهذا يعني أيضًا أن عنصرَين من عناصر DataSource قد يمثلان مصدر البيانات نفسه حتى إذا لم يكونا متساويين.

التنسيق الدقيق لرقم تعريف مصدر البيانات الذي تم إنشاؤه من خلال تطبيق Android هو: type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName

التنسيق الدقيق لرقم تعريف مصدر البيانات الذي أنشأه عميل REST هو: type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName

في حال عدم توفّر أي من الحقول الاختيارية التي تشكِّل رقم تعريف مصدر البيانات، سيتم حذفها من رقم تعريف مصدر البيانات. سيكون رقم تعريف مصدر البيانات الأدنى القابل للتطبيق هو: type:dataType.name:رقم مشروع المطور

أخيرًا، يتم تشويش رقم مشروع المطوّر والمعرّف الفريد للجهاز عند قراءته من قِبل أي عميل REST أو Android لم ينشئ مصدر البيانات. ولن يظهر رقم مشروع المطوِّر بشكل واضح وعادي إلا لمنشئ مصدر البيانات. وهذا يعني أنّ العميل سيرى مجموعة من data_stream_ids تختلف عن مجموعة أخرى من أجل استخدام بيانات اعتماد مختلفة.

dataType nested object يحدّد نوع البيانات مخططًا لتدفق البيانات التي يتم جمعها من خلال واجهة برمجة تطبيقات اللياقة البدنية أو إدراجها فيها أو الاستعلام عنها.
dataType.field[] list يمثل الحقل بُعدًا واحدًا من نوع البيانات.
dataType.field[].format string التنسيقات المختلفة المتوافقة لكل حقل في نوع البيانات

القيم المقبولة هي:
  • "blob"
  • "floatList"
  • "floatPoint"
  • "integer"
  • "integerList"
  • "map"
  • "string"
dataType.field[].name string تحدد اسم البيانات وتنسيقها. على عكس أسماء أنواع البيانات، لا تكون أسماء الحقول مع مساحات أسماء، ويجب أن تكون فريدة فقط داخل نوع البيانات.
dataType.name string لكل نوع بيانات اسم فريد يتميز بمساحة اسم. تتم مشاركة جميع أنواع البيانات في مساحة الاسم com.google كجزء من النظام الأساسي.
device nested object تمثّل هذه السمة جهاز مدمج (مثل هاتف أو جهاز قابل للارتداء) يمكنه حمل أجهزة الاستشعار.
device.manufacturer string الشركة المصنّعة للمنتج/الأجهزة
device.model string اسم طراز الجهاز المرئي للمستخدم النهائي
device.type string ثابت يمثّل نوع الجهاز.

القيم المقبولة هي:
  • "chestStrap"
  • "headMounted"
  • "phone"
  • "scale"
  • "smartDisplay"
  • "tablet"
  • "unknown"
  • "watch"
device.uid string الرقم التسلسلي أو معرّف فريد آخر للجهاز يتم تشويش هذا الحقل عند قراءته من قِبل أي عميل REST أو Android لم ينشئ مصدر البيانات. ولن يظهر الحقل المعرّف الفريد بشكل واضح وعادي إلا لمنشئ مصدر البيانات.

يحافظ التشويش على المساواة؛ أي، وفقًا لرقم تعريفي، إذا كان id1 == id2، obfuscated(id1) == obfuscated(id2).

device.version string سلسلة الإصدار لجهاز/برنامج الجهاز
type string رقم ثابت يصف نوع مصدر البيانات هذا. يشير إلى ما إذا كان مصدر البيانات هذا سينتج بيانات أولية أو مشتقة.

القيم المقبولة هي:
  • "derived"
  • "raw"

الإجابة

في حال نجاح هذا الإجراء، تعرض هذه الطريقة مورد Users.dataSources في نص الاستجابة.

تجربة

استخدِم مستكشف واجهات برمجة التطبيقات أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.