Users.dataSources: create

تنشئ مصدر بيانات جديدًا فريدًا في جميع مصادر البيانات التابعة لهذا المستخدم.

يُعدّ مصدر البيانات مصدرًا فريدًا لبيانات جهاز الاستشعار. ويمكن لمصادر البيانات عرض البيانات الأولية الواردة من أجهزة استشعار الأجهزة على الأجهزة المحلية أو المصاحبة. ويمكنهم أيضًا الكشف عن البيانات المستمَدة التي يتم إنشاؤها من خلال تحويل مصادر البيانات الأخرى أو دمجها. يمكن توفير مصادر بيانات متعددة لنوع البيانات نفسه. لكل نقطة بيانات في كل مجموعة بيانات يتم إدراجها في واجهة API API أو قراءتها منها، يكون لها مصدر بيانات مرتبط.

يُنشئ كل مصدر بيانات مصدرًا فريدًا لتحديثات مجموعات البيانات، باستخدام معرّف مصدر بيانات فريد. لا تؤثر جميع التغييرات في مصدر البيانات في رقم تعريف مصدر البيانات، وبالتالي يظل من الممكن اعتبار البيانات التي تم جمعها من خلال الإصدارات المُعدَّلة للتطبيق/الجهاز نفسه تنتمي إلى مصدر البيانات نفسه.

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

سيؤدي تحديد نوع بيانات غير نوع معروف (بدءًا بـ "com.google.") إلى إنشاء مصدر بيانات مع نوع بيانات مخصّص. لا يمكن قراءة أنواع البيانات المخصّصة إلا من خلال التطبيق الذي أنشأها. إنّ أنواع البيانات المخصّصة متوقّفة، وعليك استخدام أنواع البيانات العادية بدلاً من ذلك.

بالإضافة إلى حقول مصدر البيانات المضمّنة في رقم تعريف مصدر البيانات، يتم تضمين رقم مشروع مطوّر البرامج الذي تمت مصادقته عند إنشاء مصدر البيانات. يتم إخفاء رقم مشروع مطوّر البرامج هذا عند قراءته بواسطة أي مطوّر برامج آخر يقرأ أنواع البيانات العامة. التجربة الآن

طلب

طلب HTTP

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

المَعلمات

اسم المعلَمة القيمة الوصف
معلّمات المسار
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 الذي أنشأ تطبيقًا أو مصدر بيانات.
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 في نص الاستجابة.

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

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