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 project number

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

dataType nested object يحدد نوع البيانات المخطط لمصدر البيانات التي يتم جمعها من خلال واجهة برمجة تطبيقات Fitness أو إدراجها فيها أو البحث عنها.
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"

الإجابة

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

جرِّب هذه الميزة الآن.

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