Users.sessions: update

لتعديل جلسة معيّنة أو إدراجها التجربة الآن

الطلب

طلب HTTP

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

المعلمات

اسم المعلَمة القيمة الوصف
مَعلمات المسار
sessionId string رقم تعريف الجلسة المراد إنشاؤها.
userId string أنشئ جلسات للشخص المحدّد. استخدِم me للإشارة إلى المستخدم الذي تمت مصادقته. يُسمح فقط بالقيمة me في الوقت الحالي.

التفويض

يتطلب هذا الطلب تفويضًا بالنطاق التالي:

النطاق
https://www.googleapis.com/auth/fitness.activity.write

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

نص الطلب

في نص الطلب، أدخِل البيانات بالبنية التالية:

{
  "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
}
اسم الموقع القيمة الوصف Notes
id string معرّف ينشئه العميل ويكون فريدًا على مستوى جميع الجلسات التي يملكها هذا المستخدم المحدّد.
name string اسم جلسة سهل القراءة للمستخدم
description string أدخِل وصفًا لهذه الجلسة.
startTimeMillis long وقت البدء بالمللي ثانية منذ تاريخ بدء حساب الفترة والذي يكون شاملاً.
endTimeMillis long وقت الانتهاء بالمللي ثانية منذ تاريخ بدء حساب الفترة، شاملاً.
modifiedTimeMillis long طابع زمني يشير إلى وقت إجراء آخر تعديل على الجلسة
application nested object التطبيق الذي أنشأ الجلسة
application.packageName string اسم الحزمة لهذا التطبيق. يُستخدم هذا المعرّف كمعرّف فريد عند إنشائه من خلال تطبيقات Android، ولكن لا يمكن تحديده من خلال برامج REST. سيظهر رقم مشروع المطوّر لعملاء REST في أرقام تعريف مصدر بيانات مصدر البيانات، بدلاً من packageName.
application.version string إصدار التطبيق يجب عليك تحديث هذا الحقل كلما تغير التطبيق بطريقة تؤثر في حساب البيانات.
application.detailsUrl string معرّف موارد منتظم (URI) اختياري يمكن استخدامه للربط بالتطبيق مرة أخرى.
application.name string اسم هذا التطبيق. هذا الإجراء مطلوب لعملاء REST، ولكننا لا نفرض استخدامًا فريدًا لهذا الاسم. يتم توفير هذه المعلومات تيسيرًا للمطوّرين الآخرين الذين يريدون تحديد REST التي أنشأت تطبيقًا أو مصدر بيانات.
activityType integer نوع النشاط الذي تمثله هذه الجلسة.
activeTimeMillis long وقت نشاط الجلسة. في حين تحدّد start_time_millis وend_time_millis وقت الجلسة الكامل، يمكن أن يكون وقت النشاط أقصر ويمكن تحديده من خلال activity_time_millis. إذا كان الوقت غير النشط أثناء الجلسة معروفًا، يجب أيضًا إدراجه عبر نقطة بيانات com.google.activity.segment مع قيمة نشاط STILL

.

الإجابة

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

{
  "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
}
اسم الموقع القيمة الوصف Notes
id string معرّف ينشئه العميل ويكون فريدًا على مستوى جميع الجلسات التي يملكها هذا المستخدم المحدّد.
name string اسم جلسة سهل القراءة للمستخدم
description string أدخِل وصفًا لهذه الجلسة.
startTimeMillis long وقت البدء بالمللي ثانية منذ تاريخ بدء حساب الفترة والذي يكون شاملاً.
endTimeMillis long وقت الانتهاء بالمللي ثانية منذ تاريخ بدء حساب الفترة، شاملاً.
modifiedTimeMillis long طابع زمني يشير إلى وقت إجراء آخر تعديل على الجلسة
application nested object التطبيق الذي أنشأ الجلسة
application.packageName string اسم الحزمة لهذا التطبيق. يُستخدم هذا المعرّف كمعرّف فريد عند إنشائه من خلال تطبيقات Android، ولكن لا يمكن تحديده من خلال برامج REST. سيظهر رقم مشروع المطوّر لعملاء REST في أرقام تعريف مصدر بيانات مصدر البيانات، بدلاً من packageName.
application.version string إصدار التطبيق يجب عليك تحديث هذا الحقل كلما تغير التطبيق بطريقة تؤثر في حساب البيانات.
application.detailsUrl string معرّف موارد منتظم (URI) اختياري يمكن استخدامه للربط بالتطبيق مرة أخرى.
application.name string اسم هذا التطبيق. هذا الإجراء مطلوب لعملاء REST، ولكننا لا نفرض استخدامًا فريدًا لهذا الاسم. يتم توفير هذه المعلومات تيسيرًا للمطوّرين الآخرين الذين يريدون تحديد REST التي أنشأت تطبيقًا أو مصدر بيانات.
activityType integer نوع النشاط الذي تمثله هذه الجلسة.
activeTimeMillis long وقت نشاط الجلسة. في حين تحدّد start_time_millis وend_time_millis وقت الجلسة الكامل، يمكن أن يكون وقت النشاط أقصر ويمكن تحديده من خلال activity_time_millis. إذا كان الوقت غير النشط أثناء الجلسة معروفًا، يجب أيضًا إدراجه عبر نقطة بيانات com.google.activity.segment مع قيمة نشاط STILL

.

تجربة

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