تعمل على تعديل مصدر البيانات المحدَّد. لا يمكن تعديل السمات 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 |
معرّف فريد لمصدر البيانات الذي ينشئه مصدر البيانات هذا. يتضمّن المعرّف ما يلي:
التنسيق الدقيق لرقم تعريف مصدر البيانات الذي تم إنشاؤه من خلال تطبيق Android هو: type:dataType.name التنسيق الدقيق لرقم تعريف مصدر البيانات الذي أنشأه عميل REST هو: type:dataType.name في حال عدم توفّر أي من الحقول الاختيارية التي تشكِّل رقم تعريف مصدر البيانات، سيتم حذفها من رقم تعريف مصدر البيانات. سيكون رقم تعريف مصدر البيانات الأدنى القابل للتطبيق هو: type:dataType.name:رقم مشروع المطور أخيرًا، يتم تشويش رقم مشروع المطوّر والمعرّف الفريد للجهاز عند قراءته من قِبل أي عميل REST أو Android لم ينشئ مصدر البيانات. ولن يظهر رقم مشروع المطوِّر بشكل واضح وعادي إلا لمنشئ مصدر البيانات. وهذا يعني أنّ العميل سيرى مجموعة من data_stream_ids تختلف عن مجموعة أخرى من أجل استخدام بيانات اعتماد مختلفة. |
|
dataType |
nested object |
يحدّد نوع البيانات مخططًا لتدفق البيانات التي يتم جمعها من خلال واجهة برمجة تطبيقات اللياقة البدنية أو إدراجها فيها أو الاستعلام عنها. | |
dataType.field[] |
list |
يمثل الحقل بُعدًا واحدًا من نوع البيانات. | |
dataType.field[].format |
string |
التنسيقات المختلفة المتوافقة لكل حقل في نوع البيانات
القيم المقبولة هي:
|
|
dataType.field[].name |
string |
تحدد اسم البيانات وتنسيقها. على عكس أسماء أنواع البيانات، لا تكون أسماء الحقول مع مساحات أسماء، ويجب أن تكون فريدة فقط داخل نوع البيانات. | |
dataType.name |
string |
لكل نوع بيانات اسم فريد يتميز بمساحة اسم. تتم مشاركة جميع أنواع البيانات في مساحة الاسم com.google كجزء من النظام الأساسي. | |
device |
nested object |
تمثّل هذه السمة جهاز مدمج (مثل هاتف أو جهاز قابل للارتداء) يمكنه حمل أجهزة الاستشعار. | |
device.manufacturer |
string |
الشركة المصنّعة للمنتج/الأجهزة | |
device.model |
string |
اسم طراز الجهاز المرئي للمستخدم النهائي | |
device.type |
string |
ثابت يمثّل نوع الجهاز.
القيم المقبولة هي:
|
|
device.uid |
string |
الرقم التسلسلي أو معرّف فريد آخر للجهاز يتم تشويش هذا الحقل عند قراءته من قِبل أي عميل REST أو Android لم ينشئ مصدر البيانات. ولن يظهر الحقل المعرّف الفريد بشكل واضح وعادي إلا لمنشئ مصدر البيانات. يحافظ التشويش على المساواة؛ أي، وفقًا لرقم تعريفي، إذا كان id1 == id2، obfuscated(id1) == obfuscated(id2). |
|
device.version |
string |
سلسلة الإصدار لجهاز/برنامج الجهاز | |
type |
string |
رقم ثابت يصف نوع مصدر البيانات هذا. يشير إلى ما إذا كان مصدر البيانات هذا سينتج بيانات أولية أو مشتقة.
القيم المقبولة هي:
|
الإجابة
في حال نجاح هذا الإجراء، تعرض هذه الطريقة مورد Users.dataSources في نص الاستجابة.
تجربة
استخدِم مستكشف واجهات برمجة التطبيقات أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.