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 รายการในระยะเวลาดังกล่าว ให้สร้างเซสชันสำหรับประเภทกิจกรรมหลัก และสร้างเซสชันหลายกลุ่มสำหรับประเภทกิจกรรมที่ต่างกัน เช่น ถ้านักเรียนชกมวยและต่อยมวยเล็กน้อยในชั้นเรียนศิลปะการต่อสู้แบบผสม ให้สร้างเซสชันสำหรับศิลปะการต่อสู้แบบผสม จากนั้นคุณสามารถแยกกิจกรรม ประเภทต่างๆ ออกเป็นกลุ่มต่างๆ

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

REST

ชื่อ	`com.google.activity.segment`
ขอบเขตสิทธิ์ OAuth	https://www.googleapis.com/auth/fitness.activity.read https://www.googleapis.com/auth/fitness.activity.write
ช่อง (รูปแบบ - หน่วย)	activity type (`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
ช่อง (รูปแบบ - หน่วย)	รอบ [revolutions] (`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
ช่อง (รูปแบบ - หน่วย)	วัตต์ (`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 ก้าวต่อวินาที

ออกกำลังกาย

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

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)

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

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

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