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
}
اسم الموقع القيمة الوصف ملاحظات
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 وقت الجلسة بالكامل، يمكن أن يكون وقت النشاط أقصر ويتم تحديده من خلال active_time_millis. إذا كان وقت عدم النشاط أثناء الجلسة معروفًا، يجب أيضًا إدراجه عبر نقطة بيانات com.google.activity.segment مع قيمة نشاط STILL

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

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

جرّب الآن

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