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 مع السمات التالية:

اسم الموقع القيمة الوصف ملاحظات
الخصائص المطلوبة
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:developer number

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

dataType nested object يحدد نوع البيانات مخطط مصدر البيانات التي يتم جمعها من خلال Fitness API أو إدراجها فيها أو الاستعلام عنها.
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 لم ينشئ مصدر البيانات. لن يتمكن سوى منشئ مصدر البيانات من رؤية الحقل uid بشكل واضح وطبيعي.

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

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

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

الرد

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

جرّب الآن

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