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 نیز درج شود.

آن را امتحان کنید!

از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.