تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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`	علامة للإشارة إلى أن الخادم لديه المزيد من البيانات للنقل. لا تستخدم هذا الحقل. ولا تتم تعبئته مطلقًا في الردود من الخادم.

جرِّب هذه الميزة الآن.

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