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
}

اسم الموقع	القيمة	الوصف	ملاحظات
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 وقت الجلسة بالكامل، يمكن أن يكون وقت النشاط أقصر ويتم تحديده من خلال active_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
}

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

جرّب الآن

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