Google Fit API รวมถึง Google Fit REST API จะใช้งานไม่ได้อีกต่อไปหลังจากวันที่ 30 มิถุนายน 2025 ตั้งแต่วันที่ 1 พฤษภาคม 2024 นักพัฒนาแอปจะลงชื่อสมัครใช้ API เหล่านี้ไม่ได้

โปรดดูวิธีการเกี่ยวกับ API หรือแพลตฟอร์มที่ต้องการย้ายข้อมูลไปยังคำแนะนำในการย้ายข้อมูล Health Connect สําหรับการเปรียบเทียบ Health Connect กับ Google Fit API และ Fitbit Web API โปรดไปที่คู่มือการเปรียบเทียบ Health Connect

ดูข้อมูลเพิ่มเติมเกี่ยวกับ Health Connect และวิธีผสานรวมกับ API

หน้านี้ได้รับการแปลโดย Cloud Translation API

ประเภทข้อมูลกิจกรรม

ข้อมูลประเภทเหล่านี้สามารถใช้เพื่อบันทึกกิจกรรม การออกกำลังกาย และเมตริกต่างๆ สำหรับการออกกำลังกาย

กิจกรรม

ข้อมูลประเภทนี้ใช้เพื่อบันทึกกิจกรรมต่างๆ ของผู้ใช้ได้ ประเภท กิจกรรมการออกกำลังกายทั่วไป เช่น การวิ่งหรือกีฬาต่างๆ เช่น การทำสมาธิ การทำสวน และการนอนหลับ

หากผู้ใช้ทำกิจกรรมมากกว่า 1 กิจกรรมในช่วงเวลาดังกล่าว ให้สร้าง เซสชันสำหรับประเภทกิจกรรมหลัก และหลายกลุ่มสำหรับกิจกรรมประเภทต่างๆ เช่น ถ้าพวกเขาใช้ท่าเตะมวยและชกมวยเล็กน้อยระหว่างศิลปะการต่อสู้แบบผสม สร้างเซสชันสำหรับศิลปะการต่อสู้แบบผสม จากนั้นคุณก็สามารถแจกแจงประเภทกิจกรรมต่างๆ ออกเป็นกลุ่มได้

จุดข้อมูลแต่ละจุดต้องมีเวลาเริ่มต้นและเวลาสิ้นสุด จุดข้อมูลไม่จำเป็นต้องอยู่ติดกันหรืออยู่ถัดกันโดยตรง อาจมีช่องว่างระหว่างกันได้

RESTAndroid

ชื่อ	`com.google.activity.segment`
ขอบเขตของสิทธิ์ OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
ช่อง (รูปแบบ - หน่วย)	ประเภทกิจกรรม (`int` - enum) ประเภทกิจกรรมที่ผู้ใช้ทําอยู่ ดูรายการประเภทกิจกรรมได้ที่นี่

ชื่อ	`com.google.activity.segment`
ออบเจ็กต์ประเภทข้อมูล	`TYPE_ACTIVITY_SEGMENT`
สิทธิ์ Android	`ACTIVITY_RECOGNITION`
ช่อง (รูปแบบ - หน่วย)	FIELD_ACTIVITY (`int`—enum) ประเภทกิจกรรมที่ผู้ใช้ทำ ดูรายการประเภทกิจกรรมที่นี่

อัตราการเผาผลาญขณะพัก (BMR)

ข้อมูลประเภทนี้บันทึก BMR ของผู้ใช้เป็นกิโลแคลอรี แต่ละจุดข้อมูล แสดงถึงจำนวนกิโลแคลอรีที่ผู้ใช้จะเผาผลาญหากอยู่เฉยๆ ทั้งวัน ตามส่วนสูงและน้ำหนัก คุณควรตั้งค่าเฉพาะเวลาสิ้นสุด ซึ่งจะใช้เป็นการประทับเวลาของการอ่าน

RESTAndroid

ชื่อ	`com.google.calories.bmr`
ขอบเขตของสิทธิ์ OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
ช่อง (รูปแบบ - หน่วย)	แคลอรี (`float`—กิโลแคลอรีต่อวัน) จำนวนกิโลแคลอรี่ที่ผู้ใช้จะเผาผลาญหากพักผ่อนทั้งวัน โดยอิงตามส่วนสูงและน้ำหนัก

ชื่อ	`com.google.calories.bmr`
ออบเจ็กต์ประเภทข้อมูล	`TYPE_BASAL_METABOLIC_RATE`
ฟิลด์ (format—units)	FIELD_CALORIES (`float`—กิโลแคลอรีต่อวัน) จำนวนกิโลแคลอรี่ที่ผู้ใช้จะเผาผลาญหากพักผ่อนทั้งวัน โดยอิงตามอายุ น้ำหนัก และส่วนสูง

แคลอรี่ที่ใช้ไป

ข้อมูลประเภทนี้จะบันทึกแคลอรี่ทั้งหมด (เป็นกิโลแคลอรี) ที่เผาผลาญไปโดย ของผู้ใช้ รวมถึงแคลอรีที่เผาผลาญขณะพักผ่อน (BMR) จุดข้อมูลแต่ละจุดแสดงปริมาณกิโลแคลอรี่ทั้งหมดที่เผาผลาญในช่วงระยะเวลาหนึ่ง คุณจึงควรตั้งค่าทั้งเวลาเริ่มต้นและเวลาสิ้นสุด

RESTAndroid

ชื่อ	`com.google.calories.expended`
ขอบเขตของสิทธิ์ OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
ช่อง (รูปแบบ - หน่วย)	แคลอรี่ (`float`—kcal) จำนวนกิโลแคลอรีที่เผาผลาญ

ชื่อ	`com.google.calories.expended`
ออบเจ็กต์ประเภทข้อมูล	`TYPE_CALORIES_EXPENDED`
สิทธิ์ของ Android	`ACTIVITY_RECOGNITION`
ช่อง (รูปแบบ - หน่วย)	FIELD_CALORIES (`float` - กิโลแคลอรี) จํานวนกิโลแคลอรี่ที่ใช้ไป

จังหวะการถีบจักรยาน

หากผู้ใช้ปั่นจักรยาน ระบบจะใช้ข้อมูลประเภทนี้เพื่อบันทึกการปั่นจักรยานได้ เป็นรอบหมุนต่อนาที (RPM) แต่ละจุดข้อมูลแสดงการวัดอัตราการถีบจักรยานแบบทันที ดังนั้นคุณควรตั้งค่าเฉพาะเวลาสิ้นสุด ซึ่งจะใช้เป็นการประทับเวลาของการอ่าน

RESTAndroid

ชื่อ	`com.google.cycling.pedaling.cadence`
ขอบเขตของสิทธิ์ OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
ช่อง (รูปแบบ - หน่วย)	รอบต่อนาที (`float`—รอบต่อนาที) จำนวนรอบการหมุนของข้อเหวี่ยงจักรยานต่อนาที

ชื่อ	`com.google.cycling.pedaling.cadence`
ออบเจ็กต์ประเภทข้อมูล	`TYPE_CYCLING_PEDALING_CADENCE`
ช่อง (รูปแบบ - หน่วย)	FIELD_RPM (`float` - รอบต่อนาที) จำนวนรอบหมุนของข้อเหวี่ยงจักรยานต่อนาที

การถีบจักรยานแบบสะสม

หากผู้ใช้ปั่นจักรยาน ประเภทข้อมูลนี้สามารถใช้เพื่อบันทึกจํานวนการหมุนของข้อเหวี่ยงในระยะเวลาหนึ่ง แต่ละจุดข้อมูลแสดงจํานวนการหมุนนับตั้งแต่การนับ ณ เวลาเริ่มต้น

RESTAndroid

ชื่อ	`com.google.cycling.pedaling.cumulative`
ขอบเขตของสิทธิ์ OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
ช่อง (รูปแบบ - หน่วย)	รอบ (`int`—จำนวน) จำนวนรอบหมุนของข้อเหวี่ยงจักรยานในช่วงระยะเวลาหนึ่ง

ชื่อ	`com.google.cycling.pedaling.cumulative`
ออบเจ็กต์ประเภทข้อมูล	`TYPE_CYCLING_PEDALING_CUMULATIVE`
ฟิลด์ (format—units)	FIELD_REVOLUTIONS (`int` - จำนวน) จำนวนรอบหมุนของข้อเหวี่ยงจักรยานในช่วงระยะเวลาหนึ่ง

คะแนนคาร์ดิโอ

ข้อมูลประเภทนี้จะบันทึกจำนวนคะแนนคาร์ดิโอที่ผู้ใช้ได้รับ กิจกรรมของตนเอง แต่ละจุดข้อมูลแสดงจำนวนคะแนนคาร์ดิโอที่คำนวณ สำหรับช่วงเวลาหนึ่ง

ผู้ใช้สามารถตั้งเป้าหมายคะแนนคาร์ดิโอประจำวันและติดตามความคืบหน้าได้ คะแนนคาร์ดิโอ คำนวณได้โดยใช้สิ่งต่อไปนี้

อัตราการเต้นของหัวใจ
ค่าเทียบเท่าการเผาผลาญ (MET)
ความเร็วในการเดิน

จำนวนคะแนนคาร์ดิโอที่ได้รับจะขึ้นอยู่กับความหนักหน่วงของกิจกรรม ใช้ คู่มือนี้ในการคำนวณและเขียนคะแนนคาร์ดิโอ

ข้อมูล	1 HP (กิจกรรมความหนักต่ำปานกลาง)	2 HP (กิจกรรมที่มีระดับความเข้มข้นสูง)
อัตราการเต้นของหัวใจ	ออกกำลังกาย 1 นาทีที่อัตราการเต้นของหัวใจสูงสุด >50%	ทำกิจกรรม 1 นาทีที่อัตราการเต้นของหัวใจสูงสุด >70%
ค่า MET	3-6 MET เช่น การพายเรือหรือปีนหน้าผา	>6 MET เช่น HIIT, สกี, วอลเลย์บอล หรือฟุตบอล
ความเร็วในการเดิน	100-130 ก้าวต่อนาที	มากกว่า 130 ก้าวต่อนาที

RESTAndroid

ชื่อ	`com.google.heart_minutes`
ขอบเขตของสิทธิ์ OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
ฟิลด์ (format—units)	intensity (`float` - คะแนนคาร์ดิโอ) คะแนนคาร์ดิโอที่ได้รับจากความหนักหน่วงของการออกกำลังกายหรือกิจกรรมที่ผู้ใช้ทำ

ชื่อ	`com.google.heart_minutes`
ออบเจ็กต์ประเภทข้อมูล	`TYPE_HEART_MINUTES`
ฟิลด์ (format—units)	FIELD_INTENSITY (`float` — คะแนนคาร์ดิโอ) ความหนักหน่วงของการออกกำลังกายหรือกิจกรรมที่ผู้ใช้ทำ กิจกรรมการเคลื่อนไหวร่างกายระดับเบาถึงปานกลาง 1 นาที (เช่น การเดินเร็วกว่า 2.5 ไมล์ต่อชั่วโมง หรือการปั่นจักรยานเร็วกว่า 10 ไมล์ต่อชั่วโมง) จะได้คะแนนคาร์ดิโอ 1 คะแนน นานกว่า 1 นาที การทำกิจกรรมที่หนักหน่วงจะได้รับคะแนนคาร์ดิโอ 2 คะแนน

นาทีที่เคลื่อนไหว

ประเภทข้อมูลนี้จะบันทึกจํานวนนาทีการเคลื่อนไหวที่ Google Fit คํานวณว่าผู้ใช้ได้รับจากกิจกรรมทั้งหมด จุดข้อมูลแต่ละจุดแสดงข้อมูล จำนวนนาทีที่เคลื่อนไหวในช่วงเวลาหนึ่งๆ ต้องตั้งค่าทั้งเวลาเริ่มต้นและเวลาสิ้นสุด

ผู้ใช้จะได้คะแนนกิจกรรมทั้งหมด (นาที) จากกิจกรรมใดๆ เช่น โยคะ การเต้น หรือการทำสวน และงานบ้านอื่นๆ หากนักเรียนไปเดินเล่น Google Fit จะได้รับรางวัล 1 ครั้ง นาทีทุกครั้งที่เด็กเดินอย่างน้อย 30 ก้าวภายใน 60 วินาที

RESTAndroid

ชื่อ	`com.google.active_minutes`
ขอบเขตของสิทธิ์ OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
ฟิลด์ (format—units)	duration (`int` - มิลลิวินาที) ระยะเวลาของนาทีที่เคลื่อนไหวที่ได้รับเป็นมิลลิวินาที ช่วงที่ใช้ได้: >=0

ชื่อ	`com.google.active_minutes`
ออบเจ็กต์ประเภทข้อมูล	`TYPE_MOVE_MINUTES`
ช่อง (รูปแบบ - หน่วย)	FIELD_DURATION (`int`—มิลลิวินาที) ระยะเวลาของนาทีที่เคลื่อนไหวที่ได้รับเป็นมิลลิวินาที ช่วงที่ใช้ได้: 0 - Long.MAX_VALUE

กำลัง

ประเภทข้อมูลนี้จะบันทึกพลังงานที่ผู้ใช้สร้างขึ้นเมื่อทำกิจกรรม ซึ่งวัดเป็นวัตต์ เช่น การใช้เครื่องวัดกำลังไฟฟ้าเมื่อออกกำลังกายบนจักรยานอยู่กับที่ แต่ละจุดข้อมูลจะแสดงการวัดแบบทันทีของ พลังงานที่ผลิตขึ้น

แต่ละจุดข้อมูลจะแสดงการวัดค่ากำลังที่เกิดขึ้นแบบทันที ดังนั้นจึงมีเพียง ก็ควรตั้งเวลาสิ้นสุด ระบบจะใช้ค่านี้เป็นการประทับเวลาสำหรับการอ่าน

RESTAndroid

ชื่อ	`com.google.power.sample`
ขอบเขตของสิทธิ์ OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
ช่อง (รูปแบบ - หน่วย)	watts (`float` - วัตต์) กำลังไฟฟ้าที่ผลิตเป็นวัตต์

ชื่อ	`com.google.power.sample`
ออบเจ็กต์ประเภทข้อมูล	`TYPE_POWER_SAMPLE`
ฟิลด์ (format—units)	FIELD_WATTS (`float` - วัตต์) กำลังไฟฟ้าในหน่วยวัตต์

จังหวะการนับจำนวนก้าว

ข้อมูลประเภทนี้จะบันทึกความถี่ในการเดิน ซึ่งวัดเป็นหน่วยก้าวต่อนาที แต่ละจุดข้อมูลแสดงการวัดจังหวะการก้าวเป็นจำนวนก้าวต่อนาที ณ ขณะนั้น

RESTAndroid

ชื่อ	`com.google.step_count.cadence`
ขอบเขตของสิทธิ์ OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
ฟิลด์ (format—units)	รอบต่อนาที (`float` - ก้าว/นาที) จังหวะการก้าววัดเป็นหน่วยก้าวต่อนาที

ชื่อ	`com.google.step_count.cadence`
ออบเจ็กต์ประเภทข้อมูล	`TYPE_STEP_COUNT_CADENCE`
ช่อง (รูปแบบ - หน่วย)	FIELD_RPM (`float`— ก้าว/นาที) จังหวะการก้าววัดเป็นหน่วยก้าวต่อนาที

เดลต้าจำนวนก้าว

ประเภทข้อมูลนี้จะบันทึกจํานวนก้าวที่เดินไปนับตั้งแต่การอ่านครั้งล่าสุด ระบบจะรายงานแต่ละขั้นตอนเพียงครั้งเดียว ดังนั้นจุดข้อมูลจึงไม่ควรมีเวลาที่ทับซ้อนกัน เวลาเริ่มต้นของจุดข้อมูลแต่ละจุดควรแสดงจุดเริ่มต้นของช่วงเวลาใน ขั้นตอนต่างๆ ที่ได้ดำเนินการ

เวลาเริ่มต้นต้องเท่ากับหรือมากกว่าเวลาสิ้นสุด เวลาของจุดข้อมูลก่อนหน้า การบวกค่าทั้งหมดเข้าด้วยกันเป็นระยะเวลาหนึ่ง จะคำนวณจำนวนก้าวทั้งหมดในช่วงเวลานั้น

RESTAndroid

ชื่อ com.google.step_count.delta

ขอบเขตของสิทธิ์ OAuth

https://www.googleapis.com/auth/fitness.activity.read

https://www.googleapis.com/auth/fitness.activity.write

ช่อง (รูปแบบ - หน่วย)

steps (int—count)

จำนวนก้าวที่เดินในช่วงเวลาหนึ่ง

ช่วงที่ถูกต้อง: 0—10 ก้าวต่อวินาที

ชื่อ com.google.step_count.delta

ออบเจ็กต์ประเภทข้อมูล TYPE_STEP_COUNT_DELTA

สิทธิ์ของ Android ACTIVITY_RECOGNITION

ช่อง (รูปแบบ - หน่วย)

TYPE_STEP_COUNT_DELTA (int - จำนวน)

จำนวนขั้นตอนที่ใช้ในช่วงเวลาหนึ่ง

ช่วงที่ใช้ได้: 0-10 ขั้นตอนต่อวินาที

ออกกำลังกาย

จุดข้อมูลแต่ละจุดแสดงชุดการออกกำลังกายต่อเนื่องชุดเดียวที่ผู้ใช้ทํา จุดข้อมูลจะมีช่องสำหรับประเภทการออกกำลังกาย (สำหรับ ตัวอย่างการออกกำลังกายแบบใช้แรงต้าน หรือ เวทเทรนนิ่ง) จำนวนครั้งที่ทำซ้ำ การออกกำลังกาย ระยะเวลาของการออกกำลังกาย และความต้านทาน

RESTAndroid

ชื่อ com.google.activity.exercise

ขอบเขตของสิทธิ์ OAuth

https://www.googleapis.com/auth/fitness.activity.read

https://www.googleapis.com/auth/fitness.activity.write

ช่อง (รูปแบบ - หน่วย)

exercise (int - enum)

ค่าที่แสดงถึงการออกกำลังกายต่างๆ เช่น การออกกำลังกายด้วยการยกน้ำหนัก การออกกำลังกายฝึกความแข็งแรง และการออกกำลังกายหัวใจและหลอดเลือด

ค่าที่ยอมรับ

back_extension
bridge.hip.single_leg
burpee
calf_press
calf_raise
calf_raise.seated
calf_raise.standing
chinup
clean
clean.hang
clean.hang_power
clean.jerk
clean.power
crunch
crunch.twisting
curl.bicep
deadlift
deadlift.rdl
deadlift.single_leg
deadlift.straight_leg
dip
dip.chest
dip.triceps
fly
good_morning
hip_extension
hip_raise
hip_thrust
jumping_jack
leg_curl
leg_extension
leg_press
leg_raise
lunge
lunge.rear
lunge.side
plank
plank.side
press.bench
press.bench.close_grip
press.bench.decline
press.bench.incline
press.jm
press.pike
press.shoulder
press.shoulder.arnold
press.shoulder.military
pulldown
pullover
pullup
pushup
pushup.close_grip
pushup.pike
raise.front
raise.lateral
raise.lateral.rear
row
row.high
row.upright
run.high_knee
russian_twist
shrug
situp
situp.twisting
squat
step_up
swing
thruster
triceps_extension
vups
wall_sit

การทำซ้ำ (int—enum)

จำนวนการทําซ้ำของการออกกำลังกาย

ประเภทผู้ต้าน (int - enum)

ประเภทของความต้านทานที่ใช้ระหว่างการออกกำลังกาย

ค่าที่ยอมรับ

"intVal": 0 // The resistance type is unknown, unspecified, or can't be represented by a value.
"intVal": 1 // The user is using a barbell for resistance.
"intVal": 2 // The user is using a cable for resistance. If using 2 cables are used (one for each arm), include the resistance weight for one arm.
"intVal": 3 // The user is using dumbells for resistance.
"intVal": 4 // The user is using a kettlebell for resistance
"intVal": 5 // The user is performing the exercise in a machine.
"intVal": 6 // The user is using their own body weight for resistance.

แรงต้าน (float - กก.)

ความต้านทานของการออกกำลังกาย (หรือน้ำหนัก) เป็นกิโลกรัม

duration (int - มิลลิวินาที)

ระยะเวลาของการออกกำลังกายที่มีระยะเวลาสำคัญ

ชื่อ com.google.activity.exercise

ฟิลด์ (format—units)

FIELD_EXERCISE (int—enum)

ค่าที่แสดงถึงการออกกำลังกายประเภทต่างๆ เช่น การออกกำลังกายด้วยการยกน้ำหนัก การออกกำลังกายด้วยการฝึกความแข็งแรง และการออกกำลังกายแบบคาร์ดิโอ

ค่าที่ยอมรับ

ARNOLD_PRESS
BACK_EXTENSION
BENCH_PRESS
BICEP_CURL
BURPEE
CALF_PRESS
CALF_RAISE
CHEST_DIP
CHINUP
CLEAN
CLEAN_JERK
CLOSE_GRIP_BENCH_PRESS
CLOSE_GRIP_PUSHUP
CRUNCH
DEADLIFT
DECLINE_BENCH_PRESS
DIP
FLY
FRONT_RAISE
GOOD_MORNING
HANG_CLEAN
HANG_POWER_CLEAN
HIGH_KNEE_RUN
HIGH_ROW
HIP_EXTENSION
HIP_RAISE
HIP_THRUST
INCLINE_BENCH_PRESS
JM_PRESS
JUMPING_JACK
LATERAL_RAISE
LEG_CURL
LEG_EXTENSION
LEG_PRESS
LEG_RAISE
LUNGE
MILITARY_PRESS
PIKE_PRESS
PIKE_PUSHUP
PLANK
POWER_CLEAN
PULLDOWN
PULLOVER
PULLUP
PUSHUP
RDL_DEADLIFT
REAR_LATERAL_RAISE
REAR_LUNGE
ROW
RUSSIAN_TWIST
SEATED_CALF_RAISE
SHOULDER_PRESS
SHRUG
SIDE_LUNGE
SIDE_PLANK
SINGLE_LEG_DEADLIFT
SINGLE_LEG_HIP_BRIDGE
SITUP
SQUAT
STANDING_CALF_RAISE
STEP_UP
STRAIGHT_LEG_DEADLIFT
SWING
THRUSTER
TRICEPS_DIP
TRICEPS_EXTENSION
TWISTING_CRUNCH
TWISTING_SITUP
UPRIGHT_ROW
V_UPS
WALL_SIT

FIELD_REPETITIONS (int - จํานวน)

จำนวนการทําซ้ำของการออกกำลังกาย

FIELD_RESISTANCE_TYPE (int—enum)

ประเภทของความต้านทานที่ใช้ระหว่างการออกกำลังกาย

ค่าที่ยอมรับ

RESISTANCE_TYPE_UNKNOWN // The resistance type is unknown, unspecified, or can't be represented by a value.
RESISTANCE_TYPE_BARBELL // The user is using a barbell for resistance.
RESISTANCE_TYPE_CABLE // The user is using a cable for resistance. If using 2 cables are used (one for each arm), include the resistance weight for one arm.
RESISTANCE_TYPE_DUMBBELL // The user is using dumbells for resistance.
RESISTANCE_TYPE_KETTLEBELL // The user is using a kettlebell for resistance
RESISTANCE_TYPE_MACHINE // The user is performing the exercise in a machine.
RESISTANCE_TYPE_BODY // The user is using their own body weight for resistance.

FIELD_RESISTANCE (float—กก.)

ความต้านทานของการออกกำลังกาย (หรือน้ำหนัก) เป็นกิโลกรัม

FIELD_DURATION (int—มิลลิวินาที)

ระยะเวลาของการออกกำลังกายที่มีระยะเวลาสำคัญ