Users.dataSources: create

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

مصدر البيانات هو مصدر فريد لبيانات جهاز الاستشعار. يمكن أن تكشف مصادر البيانات البيانات الأولية الواردة من أجهزة استشعار الأجهزة الموجودة على الأجهزة المحلية أو الأجهزة المصاحبة. هم أيضًا كشف البيانات المشتقة، التي يتم إنشاؤها عن طريق تحويل أو دمج بيانات أخرى المصادر. يمكن أن توجد مصادر بيانات متعددة لنفس نوع البيانات. كل البيانات نقطة في كل مجموعة بيانات يتم إدراجها أو قراءتها من خلال Fitness 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 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 في نص الاستجابة.

جرّب الآن

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