API Reference

يتم تنظيم مرجع واجهة برمجة التطبيقات هذا حسب نوع المورد. يتسم كل نوع مورد بتمثيل واحد أو أكثر للبيانات ووسيلة واحدة أو أكثر.

أنواع الموارد

1. Users.dataSources
2. Users.dataSources.dataPointChanges
3. Users.dataSources.datasets
4. Users.dataset
5. Users.sessions

User.dataSources

لمعرفة تفاصيل الموارد المستخدمين.يمكنك الاطِّلاع على صفحة تمثيل المورد.

الطريقة	طلب HTTP	الوصف
معرّفات URI الخاصة بـ https://www.googleapis.com/fitness/v1/users، ما لم يُذكر غير ذلك
إنشاء	POST  /userId/dataSources	تنشئ مصدر بيانات جديدًا فريدًا في جميع مصادر البيانات التابعة لهذا المستخدم. يُعدّ مصدر البيانات مصدرًا فريدًا لبيانات جهاز الاستشعار. ويمكن لمصادر البيانات عرض البيانات الأولية الواردة من أجهزة استشعار الأجهزة على الأجهزة المحلية أو المصاحبة. ويمكنهم أيضًا الكشف عن البيانات المستمَدة التي يتم إنشاؤها من خلال تحويل مصادر البيانات الأخرى أو دمجها. يمكن توفير مصادر بيانات متعددة لنوع البيانات نفسه. لكل نقطة بيانات في كل مجموعة بيانات يتم إدراجها في واجهة API API أو قراءتها منها، يكون لها مصدر بيانات مرتبط. يُنشئ كل مصدر بيانات مصدرًا فريدًا لتحديثات مجموعات البيانات، باستخدام معرّف مصدر بيانات فريد. لا تؤثر جميع التغييرات في مصدر البيانات في رقم تعريف مصدر البيانات، وبالتالي يظل من الممكن اعتبار البيانات التي تم جمعها من خلال الإصدارات المُعدَّلة للتطبيق/الجهاز نفسه تنتمي إلى مصدر البيانات نفسه. يتم تحديد مصادر البيانات باستخدام سلسلة ينشئها الخادم استنادًا إلى محتوى المصدر الذي يتم إنشاؤه. يجب عدم ضبط الحقل dataStreamId عند استدعاء هذه الطريقة. وسينشئ الخادم تلقائيًا التنسيق الصحيح. وإذا تم ضبط dataStreamId، يجب أن يتطابق مع التنسيق الذي ينشئه الخادم. هذا الشكل هو مزيج من بعض الحقول من مصدر البيانات، وله ترتيب محدد. إذا لم يكن مطابقًا، سيتعذّر تنفيذ الطلب وستظهر لك رسالة خطأ. سيؤدي تحديد نوع بيانات غير نوع معروف (بدءًا بـ "com.google.") إلى إنشاء مصدر بيانات مع نوع بيانات مخصّص. لا يمكن قراءة أنواع البيانات المخصّصة إلا من خلال التطبيق الذي أنشأها. إنّ أنواع البيانات المخصّصة متوقّفة، وعليك استخدام أنواع البيانات العادية بدلاً من ذلك. بالإضافة إلى حقول مصدر البيانات المضمّنة في رقم تعريف مصدر البيانات، يتم تضمين رقم مشروع مطوّر البرامج الذي تمت مصادقته عند إنشاء مصدر البيانات. يتم إخفاء رقم مشروع مطوّر البرامج هذا عند قراءته بواسطة أي مطوّر برامج آخر يقرأ أنواع البيانات العامة.
حذف	DELETE  /userId/dataSources/dataSourceId	حذف مصدر البيانات المحدد. وسيتعذّر تنفيذ الطلب إذا كان مصدر البيانات يحتوي على أي نقاط بيانات.
الحصول	GET  /userId/dataSources/dataSourceId	لعرض مصدر البيانات المحدّد.
list	GET  /userId/dataSources	يتم إدراج جميع مصادر البيانات التي تظهر لمطوّر البرامج، باستخدام نطاقات OAuth المقدَّمة. وتجدر الإشارة إلى أن هذه القائمة ليست شاملة، إذ قد يكون لدى المستخدم مصادر بيانات خاصة لا تظهر إلا لمطوّري البرامج الآخرين أو المكالمات باستخدام نطاقات أخرى.
تحديث	PUT  /userId/dataSources/dataSourceId	يتم تعديل مصدر البيانات المحدّد. لا يمكن تعديل السمات dataStreamId وdataType وtype وdataStreamName وdevice باستثناء version. يتم تحديد مصادر البيانات من خلال dataStreamId.

User.dataSources.dataPointChanges

لمعرفة تفاصيل المورد للمستخدمين. بيانات المصدر.dataPointChanges. راجع صفحة تمثيل المورد.

الطريقة	طلب HTTP	الوصف
معرّفات URI الخاصة بـ https://www.googleapis.com/fitness/v1/users، ما لم يُذكر غير ذلك
list	GET  /userId/dataSources/dataSourceId/dataPointChanges	طلبات البحث عن تغييرات بيانات البيانات في مصدر بيانات معيّن.

User.dataSources.datasets

لمعرفة تفاصيل المورد حول المستخدمين. يمكنك الاطّلاع على صفحة تمثيل المورد.

الطريقة	طلب HTTP	الوصف
معرّفات URI الخاصة بـ https://www.googleapis.com/fitness/v1/users، ما لم يُذكر غير ذلك
حذف	DELETE  /userId/dataSources/dataSourceId/datasets/datasetId	لإجراء حذف شامل لجميع نقاط البيانات التي تتضمّن أوقات البدء والانتهاء أي تداخل مع النطاق الزمني المحدّد في رقم تعريف مجموعة البيانات. وبالنسبة إلى معظم أنواع البيانات، سيتم حذف نقطة البيانات بالكامل. بالنسبة إلى أنواع البيانات التي تمثل فيها الفاصل الزمني قيمة متسقة (مثل com.google.activity.segment) ونقطة بيانات البيانات على أيٍّ من نقطة النهاية لمجموعة البيانات، سيتم حذف الجزء المتداخل من نقطة البيانات فقط.
الحصول	GET  /userId/dataSources/dataSourceId/datasets/datasetId	تعرض مجموعة بيانات تحتوي على جميع نقاط البيانات التي تتداخل فيها أوقات البدء والانتهاء مع النطاق المحدّد للحد الأدنى لوقت بدء مجموعة البيانات والحد الأقصى لوقت الانتهاء. تحديدًا، أي نقطة بيانات يكون وقت بدءها أقل من أو يساوي وقت انتهاء مجموعة البيانات ووقت وقتها أكبر من أو يساوي وقت بدء مجموعة البيانات.
رمز تصحيح	PATCH  /userId/dataSources/dataSourceId/datasets/datasetId	تُضيف نقاط بيانات إلى مجموعة بيانات. لا حاجة إلى إنشاء مجموعة البيانات في السابق. سيتم عرض جميع النقاط ضمن مجموعة البيانات المحددة مع المكالمات اللاحقة لاسترداد مجموعة البيانات هذه. يمكن أن تنتمي نقاط البيانات إلى أكثر من مجموعة بيانات واحدة. لا تستخدِم هذه الطريقة دلالات التصحيح: يتم إدراج نقاط البيانات المُقدَّمة فقط، بدون استبدال البيانات الحالية.

Users.dataset

لمعرفة تفاصيل الموارد المستخدمين.راجِع صفحة تمثيل الموارد.

الطريقة	طلب HTTP	الوصف
معرّفات URI الخاصة بـ https://www.googleapis.com/fitness/v1/users، ما لم يُذكر غير ذلك
مجمَّع	POST  /userId/dataset:aggregate	يُجمِّع البيانات من نوع معيّن أو مصدر البيانات إلى مجموعات بيانات مقسومًا على نوع حدّ معيّن. يمكن تجميع مجموعات بيانات متعددة من أنواع متعددة ومن مصادر متعددة في نوع واحد على مستوى الحزمة لكل طلب.

جلسات المستخدمين

للحصول على تفاصيل مورد Users.sessions، راجع صفحة تمثيل المورد.

الطريقة	طلب HTTP	الوصف
معرّفات URI الخاصة بـ https://www.googleapis.com/fitness/v1/users، ما لم يُذكر غير ذلك
حذف	DELETE  /userId/sessions/sessionId	حذف جلسة محددة من خلال معرّف الجلسة المحدد.
list	GET  /userId/sessions	يسرد الجلسات التي تم إنشاؤها سابقًا.
تحديث	PUT  /userId/sessions/sessionId	يتم تعديل جلسة معيّنة أو إدراجها.