يتم تعديل مصدر البيانات المحدّد. لا يمكن تعديل السمات 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 |
معرّف فريد لمصدر البيانات الذي أنشأه مصدر البيانات هذا. ويشمل المعرّف ما يلي:
التنسيق الدقيق لمعرّف مصدر البيانات الذي تم إنشاؤه بواسطة تطبيق Android هو: type:dataType.name التنسيق الدقيق لرقم تعريف مصدر البيانات الذي أنشأه عميل REST هو: type:dataType.name عندما يكون أي من الحقول الاختيارية التي تشكّل رقم تعريف مصدر البيانات غير متوفّر، سيتم حذفها من رقم تعريف مصدر البيانات. سيكون الحد الأدنى صالحًا لمعرّف مصدر البيانات القابل للتطبيق: type:dataType.name:developer project number أخيرًا، يتم إخفاء مفاتيح فك تشفير رقم مشروع مطوّر البرامج ومعرّف الجهاز الفريد (UID) عند قراءته من قِبل أي عميل REST أو Android لم ينشئ مصدر البيانات. لن يتمكّن أحد من الاطّلاع على رقم مشروع مطوّر البرامج إلا بشكل واضح وطبيعي فقط. هذا يعني أنّ العميل سيرى مجموعة مختلفة من data_stream_ids مقارنةً ببرنامج آخر لديه بيانات اعتماد مختلفة. |
|
dataType |
nested object |
يحدد نوع البيانات المخطط لمصدر البيانات التي يتم جمعها من خلال واجهة برمجة تطبيقات Fitness أو إدراجها فيها أو البحث عنها. | |
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 لم ينشئ مصدر البيانات. سيتمكّن منشئ البيانات فقط من رؤية حقل uid في شكل واضح وعادي. يؤدي إخفاء مفاتيح فك التشفير إلى المساواة، أي تحصل على معرّفَين، إذا id1 == id2، Obfuscated(id1) == Obfuscated(id2). |
|
device.version |
string |
سلسلة الإصدار لمعدّة/برنامج الجهاز. | |
type |
string |
ثابت يصف نوع مصدر البيانات هذا. تشير إلى ما إذا كان مصدر البيانات هذا ينشئ بيانات أو بيانات مشتقة من البيانات الأولية.
القيم المقبولة هي:
|
الإجابة
وإذا نجحت، ستعرض هذه الطريقة مورد User.dataSources في نص الاستجابة.
جرِّب هذه الميزة الآن.
استخدِم "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة في البيانات المباشرة والاطّلاع على الاستجابة.