อัปเดตหรือแทรกเซสชันที่ต้องการ ลองเลย
ส่งคำขอ
คำขอ 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 ด้านล่างเพื่อเรียกใช้เมธอดนี้ในข้อมูลสดและดูการตอบสนอง