Apple Health를 Google Sheets로: 저절로 채워지는 시트
Apple Health 데이터를 Google Sheets로 가져오려면 iPhone 앱이 보내 줘야 해요. Apple Health에는 Google이 읽을 수 있는 API가 없거든요. Marrow로는 무료 방법이 두 가지 있어요. 정해진 일정에 따라 매일의 수치를 작은 Apps Script 웹 앱으로 보내서 시트가 저절로 채워지게 하거나, 앱에서 CSV를 만들어 한 번 가져오는 거예요.
아래에 두 방법 모두와 받게 되는 열, 흔한 문제 해결 방법을 정리했어요. 저희는 Marrow를 만들어요. 이 단계는 Marrow 1.7.1 기준이에요.
1. 저절로 채워지는 시트(Apps Script)
Google 계정이 필요해요. 중간에 다른 것은 거치지 않아요. Marrow가 내 시트 안에 있는 스크립트로 바로 보내요.
- Google Sheets에서 새 시트를 만드세요. Extensions를 열고 Apps Script를 여세요.
- 코드를 레시피로 바꾸고,
SECRET을 직접 정한 길고 무작위한 문자열로 바꾸세요. - Deploy를 클릭한 다음 New deployment를 클릭하고 Web app을 고르세요. Execute as를 Me로, Who has access를 Anyone으로 설정한 다음, 배포하고 권한 요청을 승인하세요. 주소를 아는 사람은 스크립트를 호출할 수만 있어요. 이를 통해 시트를 읽을 수는 없어요.
- 웹 앱 URL을 복사하세요.
/exec로 끝나요. - Marrow에서 연결을 열고 내보내기 탭으로 간 다음 Google Sheets를 탭하세요. 자동을 켜고 새로운 자동화를 탭하세요.
- 주소 아래에 URL을 붙여넣고
?key=와 비밀 값을 덧붙이세요.https://script.google.com/macros/s/…/exec?key=…처럼 보여요. Apps Script는 헤더를 읽을 수 없어서 비밀 값을 주소에 넣는 거예요. - 데이터 아래에서 데이터 유형은 건강 지표, 형식은 JSON, 형식(형태)는 중첩으로 그대로 두세요. 주기에서 얼마나 자주 실행할지 고르세요. 시트라면 하루 한 번이면 충분해요.
- 지금 실행을 탭하세요. Marrow라는 이름의 탭에 행이 나타나요.
도착하는 내용
지표마다 하루에 한 행이며, 단위는 Apple Health가 저장하는 단위를 따라요. 샘플 값:
| received_at | metric | units | date | qty | extra |
|---|---|---|---|---|---|
| 2026-11-06 09:00 | step_count | count | 2026-11-05 | 8746 | |
| 2026-11-06 09:00 | body_mass | kg | 2026-11-05 | 81.3 | |
| 2026-11-06 09:00 | heart_rate | bpm | 2026-11-05 | {"Avg":71,"Min":52,"Max":148} | |
| 2026-11-06 09:00 | sleep_analysis | 시간 | 2026-11-05 | {"totalSleep":7.4,"deep":1.1,"rem":1.6,"core":4.7} |
스크립트는 모든 Marrow 자동화가 보내는 것과 같은 JSON을 읽어요. 형식은 자동화 참고 문서에 나와 있어요:
{"data": {"metrics": [
{"name": "step_count", "units": "count",
"data": [{"date": "2026-11-05", "qty": 8746}]},
{"name": "heart_rate", "units": "bpm",
"data": [{"date": "2026-11-05", "Avg": 71, "Min": 52, "Max": 148}]}
]}}
알아 둘 점이 두 가지 있어요. 날짜 범위 마지막 실행 이후는 일부러 최근 이틀을 다시 보내요. Apple Health는 하루가 끝난 뒤에도 그날 데이터를 계속 채우기 때문에, 같은 지표와 날짜가 두 번 이상 나타날 수 있어요. 최신 값만 남기려면 received_at을 최신순으로 정렬한 다음, 지표와 날짜 열에 Data, Data cleanup, Remove duplicates를 쓰세요. 그리고 레시피는 건강 지표를 다뤄요. 운동, 리프팅 세트, 식사도 같은 요청 형태로 오기 때문에, 스크립트 몇 줄만 더하면 탭을 추가할 수 있어요.
2. CSV를 한 번 가져오기
수치를 한 번만 보고 싶다면 스크립트는 건너뛰세요.
- Marrow에서 연결을 열고 내보내기 탭으로 간 다음 직접 입력을 여세요.
- 일일 지표 아래에서 범위를 설정하고 형식으로 CSV 또는 CSV (long)를 고른 다음 내보내기 생성을 탭하세요.
- 파일을 Google Drive로 공유하세요.
- Sheets에서 File을 열고 Import를 선택한 다음 파일을 고르세요.
CSV는 하루에 한 행, 지표마다 한 열이에요. CSV (long)는 date,metric,value,unit 형태로, 피벗 테이블에 맞는 구조예요. 모든 파일은 파일 참고 문서에 설명돼 있어요.
작동하지 않는다면
- 지금 실행 후에도 행이 없어요. Apps Script 프로젝트를 열고 왼쪽의 Executions를 클릭하세요. 모든 POST가 오류와 함께 표시돼요.
- 전송은 됐는데 행이 없어요.
?key=가SECRET과 맞지 않으면 레시피는 forbidden으로 응답하지만, Marrow에는 성공으로 보여요. 주소 끝의 키를 확인하세요. - 스크립트를 고쳐도 아무 변화가 없어요. Deploy, Manage deployments에서 활성 배포를 수정하고 새 버전을 고른 다음 Deploy를 누르세요. 그렇게 하기 전까지
/exec주소는 예전 버전을 계속 실행해요. - 주소가 /dev로 끝나요. 그 주소는 로그인한 편집 권한자에게만 실행돼요. Marrow에는
/exec주소가 필요해요. - 스크립트가 전혀 실행되지 않아요. 배포 설정의 Who has access에서 로그인 없이 누구나 접근할 수 있게 설정해야 해요.
- 가져온 파일에 긴 열 하나만 보여요. 다시 가져오고 구분 기호로 쉼표를 고르세요.
- 실행이 늦어요. 백그라운드 작업 시점은 iOS가 정하고, 계속 잠겨 있는 휴대폰은 다음에 잠금이 풀릴 때 보내요. 자동화가 실행되는 시점에서 무엇을 기대하면 되는지 설명해요.
자주 묻는 질문
무료인가요?
네. 자동화와 파일 내보내기는 Marrow 무료 요금제에 포함되고, Apps Script는 Google 계정만 있으면 무료예요. 켜져 있는 자동화 하나는 무료 요금제의 연결 3개 중 하나로 계산돼요.
앱을 닫아도 시트가 업데이트되나요?
네. 자동화는 iOS가 허용하는 시점에 백그라운드에서 실행되며, 보통 하루에 여러 번이에요.
얼마나 예전 데이터까지 보낼 수 있나요?
Marrow가 읽은 만큼이요. 기본값은 Apple Health 기록 3년치이고, 설정, 데이터 유형, Apple Health 기록에서 5년, 전체, 또는 특정 날짜부터로 늘릴 수 있어요. 처음 불러올 때는 옵션 더 보기에서 자동화의 날짜 범위를 설정하고 한 번 실행한 다음, 다시 마지막 실행 이후로 돌려 두세요.
Google이 내 건강 데이터를 볼 수 있나요?
행은 내 Google 계정의 약관에 따라 내 Google 시트에 저장돼요. Marrow는 휴대폰에서 내 스크립트로 바로 보내고, 저희 서버에 사본을 남기지 않아요.
다른 방법과 각각 언제 쓰면 좋은지
- Health Auto Export는 Premium 등급에서 정해진 일정에 따라 CSV 파일을 Google Drive에 저장해요. Drive에 파일이 쌓이는 폴더를 원하거나, Mac과 iPad 앱도 쓴다면 이쪽을 고르세요. 자세한 내용은 저희 비교 글에 있어요.
- n8n, Zapier, Make. webhook으로 보내고, 도구의 Google Sheets 단계가 행을 추가하게 하세요. 이 중 하나를 이미 쓰고 있고 스크립트를 관리하고 싶지 않다면 이쪽을 고르세요. 설정 방법: n8n, Zapier, Make.
- Apple의 export.zip. 전체 기록을 한 번 가져오려면 건강 앱에서 내보내고, 브라우저에서 저희 변환기로 CSV로 바꾼 다음 파일을 가져오세요. 스냅숏이라서 새 데이터가 생기면 다시 내보내야 해요.
- Apple 단축어로도 건강 샘플 몇 개를 같은 웹 앱으로 보낼 수 있어요. 하루에 수치 한두 개만 필요하고 하나하나 직접 만드는 것이 괜찮다면 이쪽을 고르세요.
관련 글: Apple Health를 CSV로 · Apple Health를 webhook으로 · 자동화 참고 문서