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

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

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

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

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

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

กิจกรรม

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

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

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

REST

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

Android

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

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

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

REST

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

Android

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

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

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

REST

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

Android

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

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

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

REST

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

Android

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

จำนวนสะสมของการถีบจักรยาน

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

REST

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

Android

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

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

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

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

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

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

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

REST

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

Android

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

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

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

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

REST

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

Android

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

กำลัง

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

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

REST

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

Android

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

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

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

REST

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

Android

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

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

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

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

REST

ชื่อ com.google.step_count.delta

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

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

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

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

ก้าว (int - จำนวน)

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

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

Android

ชื่อ com.google.step_count.delta

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

สิทธิ์ของ Android ACTIVITY_RECOGNITION

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

TYPE_STEP_COUNT_DELTA (int - จำนวน)

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

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

ออกกำลังกาย

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

REST

ชื่อ 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 - มิลลิวินาที)

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

Android

ชื่อ com.google.activity.exercise

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

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—มิลลิวินาที)

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