Users.sessions: list

يسرد الجلسات التي تم إنشاؤها سابقًا. التجربة الآن

الطلب

طلب HTTP

GET https://www.googleapis.com/fitness/v1/users/userId/sessions

المعلمات

اسم المعلَمة القيمة الوصف
مَعلمات المسار
userId string أدرِج الجلسات للشخص المحدّد. استخدِم me للإشارة إلى المستخدم الذي تمت مصادقته. يُسمح فقط بالقيمة me في الوقت الحالي.
مَعلمات طلب البحث الاختيارية
activityType integer إذا لم يكن المحتوى فارغًا، يجب عرض الجلسات التي تتضمّن أنواع الأنشطة هذه فقط.
endTime string الطابع الزمني لـ RFC3339. لن يتم تضمين سوى الجلسات التي تنتهي بين وقت البدء ووقت الانتهاء في الرد. إذا تم حذف هذا الوقت مع تحديد startTime، سيتم عرض جميع الجلسات من startTime حتى نهاية الوقت.
includeDeleted boolean إذا كانت القيمة صحيحة، وتم حذف كل من startTime وendTime، سيتم عرض عمليات حذف الجلسات.
pageToken string الرمز المميّز للمتابعة، والذي يُستخدم للمزامنة التزايدية. للحصول على الدفعة التالية من التغييرات، اضبط هذه المَعلمة على قيمة nextPageToken من الردّ السابق. يتم تجاهل الرمز المميّز للصفحة إذا تم تحديد وقت البدء أو وقت الانتهاء. إذا لم يتم تحديد وقت البدء أو وقت الانتهاء أو الرمز المميز للصفحة، فسيتم عرض الجلسات التي تم تعديلها في آخر 30 يومًا.
startTime string الطابع الزمني لـ RFC3339. لن يتم تضمين سوى الجلسات التي تنتهي بين وقت البدء ووقت الانتهاء في الرد. إذا تم حذف هذا الوقت ولكن تم تحديد endTime، سيتم عرض جميع الجلسات التي تمت من بداية الوقت وحتى endTime.

التفويض

يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية:

النطاق
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
https://www.googleapis.com/auth/fitness.nutrition.read
https://www.googleapis.com/auth/fitness.nutrition.write
https://www.googleapis.com/auth/fitness.blood_pressure.read
https://www.googleapis.com/auth/fitness.blood_pressure.write
https://www.googleapis.com/auth/fitness.blood_glucose.read
https://www.googleapis.com/auth/fitness.blood_glucose.write
https://www.googleapis.com/auth/fitness.oxygen_saturation.read
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
https://www.googleapis.com/auth/fitness.body_temperature.read
https://www.googleapis.com/auth/fitness.body_temperature.write
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write

للحصول على مزيد من المعلومات، يمكنك الاطلاع على صفحة المصادقة والتفويض.

نص الطلب

لا توفِّر نص طلب بهذه الطريقة.

الإجابة

إذا نجحت هذه الطريقة، ستعرض هذه الطريقة نص استجابة بالبنية التالية:

{
  "session": [
    {
      "id": string,
      "name": string,
      "description": string,
      "startTimeMillis": long,
      "endTimeMillis": long,
      "modifiedTimeMillis": long,
      "application": {
        "packageName": string,
        "version": string,
        "detailsUrl": string,
        "name": string
      },
      "activityType": integer,
      "activeTimeMillis": long
    }
  ],
  "deletedSession": [
    {
      "id": string,
      "name": string,
      "description": string,
      "startTimeMillis": long,
      "endTimeMillis": long,
      "modifiedTimeMillis": long,
      "application": {
        "packageName": string,
        "version": string,
        "detailsUrl": string,
        "name": string
      },
      "activityType": integer,
      "activeTimeMillis": long
    }
  ],
  "nextPageToken": string,
  "hasMoreData": boolean
}
اسم الموقع القيمة الوصف Notes
session[] list الجلسات التي تتضمّن وقت انتهاء يتراوح بين startTime وendTime من الطلب.

session[].id string معرّف ينشئه العميل ويكون فريدًا على مستوى جميع الجلسات التي يملكها هذا المستخدم المحدّد.
session[].name string اسم جلسة سهل القراءة للمستخدم
session[].description string أدخِل وصفًا لهذه الجلسة.
session[].startTimeMillis long وقت البدء بالمللي ثانية منذ تاريخ بدء حساب الفترة والذي يكون شاملاً.
session[].endTimeMillis long وقت الانتهاء بالمللي ثانية منذ تاريخ بدء حساب الفترة، شاملاً.
session[].modifiedTimeMillis long طابع زمني يشير إلى وقت إجراء آخر تعديل على الجلسة
session[].application nested object التطبيق الذي أنشأ الجلسة
session[].application.packageName string اسم الحزمة لهذا التطبيق. يُستخدم هذا المعرّف كمعرّف فريد عند إنشائه من خلال تطبيقات Android، ولكن لا يمكن تحديده من خلال برامج REST. سيظهر رقم مشروع المطوّر لعملاء REST في أرقام تعريف مصدر بيانات مصدر البيانات، بدلاً من packageName.
session[].application.version string إصدار التطبيق يجب عليك تحديث هذا الحقل كلما تغير التطبيق بطريقة تؤثر في حساب البيانات.
session[].application.detailsUrl string معرّف موارد منتظم (URI) اختياري يمكن استخدامه للربط بالتطبيق مرة أخرى.
session[].application.name string اسم هذا التطبيق. هذا الإجراء مطلوب لعملاء REST، ولكننا لا نفرض استخدامًا فريدًا لهذا الاسم. يتم توفير هذه المعلومات تيسيرًا للمطوّرين الآخرين الذين يريدون تحديد REST التي أنشأت تطبيقًا أو مصدر بيانات.
session[].activityType integer نوع النشاط الذي تمثله هذه الجلسة.
deletedSession[] list إذا تم ضبط includeDeleted على "صحيح" في الطلب وحذف السمتَين startTime وendTime، سيتضمّن ذلك الجلسات التي تم حذفها منذ آخر مزامنة.
deletedSession[].id string معرّف ينشئه العميل ويكون فريدًا على مستوى جميع الجلسات التي يملكها هذا المستخدم المحدّد.
deletedSession[].name string اسم جلسة سهل القراءة للمستخدم
deletedSession[].description string أدخِل وصفًا لهذه الجلسة.
deletedSession[].startTimeMillis long وقت البدء بالمللي ثانية منذ تاريخ بدء حساب الفترة والذي يكون شاملاً.
deletedSession[].endTimeMillis long وقت الانتهاء بالمللي ثانية منذ تاريخ بدء حساب الفترة، شاملاً.
deletedSession[].modifiedTimeMillis long طابع زمني يشير إلى وقت إجراء آخر تعديل على الجلسة
deletedSession[].application nested object التطبيق الذي أنشأ الجلسة
deletedSession[].application.packageName string اسم الحزمة لهذا التطبيق. يُستخدم هذا المعرّف كمعرّف فريد عند إنشائه من خلال تطبيقات Android، ولكن لا يمكن تحديده من خلال برامج REST. سيظهر رقم مشروع المطوّر لعملاء REST في أرقام تعريف مصدر بيانات مصدر البيانات، بدلاً من packageName.
deletedSession[].application.version string إصدار التطبيق يجب عليك تحديث هذا الحقل كلما تغير التطبيق بطريقة تؤثر في حساب البيانات.
deletedSession[].application.detailsUrl string معرّف موارد منتظم (URI) اختياري يمكن استخدامه للربط بالتطبيق مرة أخرى.
deletedSession[].application.name string اسم هذا التطبيق. هذا الإجراء مطلوب لعملاء REST، ولكننا لا نفرض استخدامًا فريدًا لهذا الاسم. يتم توفير هذه المعلومات تيسيرًا للمطوّرين الآخرين الذين يريدون تحديد REST التي أنشأت تطبيقًا أو مصدر بيانات.
deletedSession[].activityType integer نوع النشاط الذي تمثله هذه الجلسة.
nextPageToken string الرمز المميز للمزامنة المستخدم لمزامنة المزيد من التغييرات. سيتم تقديم هذه السمة فقط إذا تم حذف كل من startTime وendTime من الطلب.
session[].activeTimeMillis long وقت نشاط الجلسة. في حين تحدّد start_time_millis وend_time_millis وقت الجلسة الكامل، يمكن أن يكون وقت النشاط أقصر ويمكن تحديده من خلال activity_time_millis. إذا كان الوقت غير النشط أثناء الجلسة معروفًا، يجب أيضًا إدراجه عبر نقطة بيانات com.google.activity.segment مع قيمة نشاط STILL

.
deletedSession[].activeTimeMillis long وقت نشاط الجلسة. في حين تحدّد start_time_millis وend_time_millis وقت الجلسة الكامل، يمكن أن يكون وقت النشاط أقصر ويمكن تحديده من خلال activity_time_millis. إذا كان الوقت غير النشط أثناء الجلسة معروفًا، يجب أيضًا إدراجه عبر نقطة بيانات com.google.activity.segment مع قيمة نشاط STILL

.
hasMoreData boolean ضَع علامة للإشارة إلى أنّ الخادم لديه المزيد من البيانات لنقلها. لا تستخدِم هذا الحقل. ولا تتم تعبئة هذا الحقل مطلقًا في الاستجابات الواردة من الخادم.

تجربة

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