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 زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.