อัปเดตหรือแทรกเซสชันที่ระบุ ลองใช้เลย
ส่งคำขอ
คำขอ 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 |
เวลาเริ่มต้นหน่วยเป็นมิลลิวินาทีนับตั้งแต่ 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.groups ที่มีค่ากิจกรรมว่าง |
คำตอบ
หากสําเร็จ เมธอดนี้จะแสดงเนื้อหาการตอบกลับโดยมีโครงสร้างดังนี้
{ "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 |
เวลาเริ่มต้นหน่วยเป็นมิลลิวินาทีนับตั้งแต่ 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.groups ที่มีค่ากิจกรรมว่าง |
ลองใช้เลย
ใช้ API Explorer ด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลสดและดูคําตอบ