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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

กิจกรรม

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

หากผู้ใช้ทํากิจกรรมมากกว่า 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` รอบต่อนาที) จำนวนรอบการหมุนของข้อเหวี่ยงจักรยานต่อนาที

การปั่นจักรยานสะสม

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

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`—count) จำนวนรอบหมุนของข้อเหวี่ยงจักรยานในช่วงระยะเวลาหนึ่ง

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

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

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

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

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

ข้อมูล	1 HP (กิจกรรมที่มีความหนักระดับต่ำถึงปานกลาง)	2 กิจกรรมที่มีความเข้มข้นสูง
อัตราการเต้นของหัวใจ	ทำกิจกรรม 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
ฟิลด์ (รูปแบบ - หน่วย)	ความเข้มข้น (`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—Long.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
ฟิลด์ (รูปแบบ - หน่วย)	รอบต่อนาที (`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—count)

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

ช่วงที่ใช้ได้: 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

repetitions (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—count)

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

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

ระยะเวลาของการออกกำลังกายที่ต้องระบุระยะเวลา