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 .

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

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