التعامل مع الجلسات

تتيح لك واجهة برمجة تطبيقات اللياقة البدنية REST إنشاء جلسات والحصول عليها. تمثّل الجلسات فاصلاً زمنيًا يحدّد المستخدمين خلاله أنشطة اللياقة البدنية.

ويتم تمثيل الجلسات من خلال مورد Users.session.

يتم تخزين الأنشطة في عدد صحيح 'ActivityType'.

ملاحظة مهمة: لمعرفة أفضل الممارسات عند إدارة بيانات المستخدمين، يُرجى الاطّلاع على الاستخدام المسؤول لتطبيق Google Fit.

إدراج جلسة

يوضح هذا المثال كيفية إدراج جلسة.

طريقة HTTP

النقطة

طلب عنوان URL

https://www.googleapis.com/fitness/v1/users/me/sessions/someSessionId

نص الطلب

{
  "id": "someSessionId",
  "name": "My example workout",
  "description": "A very intense workout",
  "startTimeMillis": 1396710000000,
  "endTimeMillis": 1396713600000,
  "version": 1,
  "lastModifiedToken": "exampleToken",
  "application": {
    "detailsUrl": "http://example.com",
    "name": "Foo Example App",
    "version": "1.0"
  },
  "activityType": 1
}

الإجابة

الرد هو رمز حالة 200 OK. يحتوي نص الاستجابة على تمثيل JSON للجلسة.

أمر Curl

$ curl --header "Authorization: Bearer ya29.1.yourtokenvalue" -X PUT \
--header "Content-Type: application/json;encoding=utf-8" -d @createsession.json \
"https://www.googleapis.com/fitness/v1/users/me/sessions/someSessionId"

إدراج الجلسات الحالية

يوضح هذا المثال كيفية سرد الجلسات الحالية من نيسان (أبريل) 2014.

طريقة HTTP

الحصول

طلب عنوان URL

https://www.googleapis.com/fitness/v1/users/me/sessions?startTime=2014-04-01T00:00:00.000Z&endTime=2014-04-30T23:59:59.999Z

نص الطلب

ما مِن نظام غذائي معيّن.

الإجابة

الاستجابة هي رمز حالة 200 OK. يحتوي نص الاستجابة على تمثيلات JSON لجميع الجلسات الحالية التي تطابق وقتَي البدء والانتهاء المقدَّمَين في معلَمات طلب البحث.

أمر Curl

$ curl --header "Authorization: Bearer ya29.1.yourtokenvalue" -X GET \
--header "Content-Type: application/json;encoding=utf-8" \
"https://www.googleapis.com/fitness/v1/users/me/sessions?startTime=2014-04-01T00:00:00.000Z&endTime=2014-04-30T23:59:59.999Z"