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	เวลาเริ่มต้นในหน่วยมิลลิวินาทีนับตั้งแต่ Epoch
endTimeMillis	long	เวลาสิ้นสุดเป็นมิลลิวินาทีตั้งแต่ Epoch
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 ที่มีค่ากิจกรรม "ยังคง" ด้วย

คำตอบ

หากทำสำเร็จ เมธอดนี้จะแสดงเนื้อหาการตอบสนองที่มีโครงสร้างต่อไปนี้

{
  "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	เวลาเริ่มต้นในหน่วยมิลลิวินาทีนับตั้งแต่ Epoch
endTimeMillis	long	เวลาสิ้นสุดเป็นมิลลิวินาทีตั้งแต่ Epoch
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 ที่มีค่ากิจกรรม "ยังคง" ด้วย

ลองใช้เลย

ใช้ API Explorer ด้านล่างเพื่อเรียกใช้เมธอดนี้ในข้อมูลสดและดูการตอบสนอง