يتم تنظيم مرجع واجهة برمجة التطبيقات هذا حسب نوع المورد. يحتوي كل نوع من أنواع الموارد على تمثيل بيانات واحد أو أكثر وطريقة واحدة أو أكثر.
أنواع الموارد
- Users.dataSources
- Users.dataSources.dataPointChanges
- Users.dataSources.datasets
- Users.dataset
- Users.sessions
Users.dataSources
بالنسبة إلى تفاصيل موارد Users.dataSources، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) المرتبطة بـ https://www.googleapis.com/fitness/v1/users، ما لم يُذكر خلاف ذلك | ||
| إنشاء |
POST /userId/dataSources
|
تنشئ مصدر بيانات جديدًا فريدًا على مستوى جميع مصادر البيانات التي تخص هذا المستخدم.
مصدر البيانات هو مصدر فريد لبيانات أداة الاستشعار. يمكن لمصادر البيانات الكشف عن البيانات الأولية الواردة من أدوات استشعار الأجهزة على الأجهزة المحلية أو المرافقة. يمكنها أيضًا الكشف عن البيانات المشتقة، التي تم إنشاؤها عن طريق تحويل أو دمج مصادر بيانات أخرى. يمكن أن توجد مصادر بيانات متعددة لنوع البيانات نفسه. لكل نقطة بيانات في كل مجموعة بيانات يتم إدراجها أو قراءتها من واجهة برمجة تطبيقات اللياقة البدنية مصدر بيانات مرتبط. ينتج كل مصدر بيانات مصدرًا فريدًا من تعديلات مجموعة البيانات، باستخدام معرّف مصدر بيانات فريد. لا تؤثر كل التغييرات التي تطرأ على مصدر البيانات في معرّف مصدر البيانات، وبالتالي فإنّ البيانات التي يتم جمعها من خلال الإصدارات المُحدَّثة من التطبيق/الجهاز نفسه من الممكن اعتبارها تابعة لمصدر البيانات نفسه. يتم تحديد مصادر البيانات باستخدام سلسلة ينشئها الخادم، استنادًا إلى محتوى المصدر الذي يتم إنشاؤه. يجب عدم ضبط الحقل 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.
|
Users.dataSources.dataPointChanges
بالنسبة إلى تفاصيل موارد Users.dataSources.dataPointChanges، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) المرتبطة بـ https://www.googleapis.com/fitness/v1/users، ما لم يُذكر خلاف ذلك | ||
| list |
GET /userId/dataSources/dataSourceId/dataPointChanges
|
عندما تتغيّر طلبات البحث لنقاط بيانات المستخدم لمصدر بيانات معيّن |
Users.dataSources.datasets
بالنسبة إلى تفاصيل موارد Users.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
بالنسبة إلى تفاصيل موارد مجموعة البيانات (Users.dataset)، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) المرتبطة بـ https://www.googleapis.com/fitness/v1/users، ما لم يُذكر خلاف ذلك | ||
| مُجمَّع |
POST /userId/dataset:aggregate
|
تجمّع البيانات من نوع معيّن أو مصدر بيانات معيّن في مجموعات مقسمة على نوع معيّن من الحدود. يمكن تجميع مجموعات بيانات متعددة من أنواع متعددة ومن مصادر متعددة في نوع حزمة واحد بالضبط لكل طلب. |
Users.sessions
بالنسبة إلى تفاصيل موارد Users.sessions، يُرجى الاطّلاع على صفحة تمثيل الموارد.
| الطريقة | طلب HTTP | الوصف |
|---|---|---|
| معرّفات الموارد المنتظمة (URI) المرتبطة بـ https://www.googleapis.com/fitness/v1/users، ما لم يُذكر خلاف ذلك | ||
| حذف |
DELETE /userId/sessions/sessionId
|
يؤدي إلى حذف جلسة محدّدة من خلال رقم تعريف الجلسة المحدّد. |
| list |
GET /userId/sessions
|
يسرد الجلسات التي تم إنشاؤها سابقًا. |
| تعديل |
PUT /userId/sessions/sessionId
|
لتعديل جلسة معيّنة أو إدراجها |