Apple Health إلى Google Sheets: جدول يملأ نفسه
لإدخال بيانات Apple Health إلى Google Sheets، يجب أن يرسلها تطبيق على iPhone، لأن Apple Health لا يملك واجهة برمجة تستطيع Google قراءتها. مع 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 | كغ | 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} |
يقرأ السكربت JSON نفسه الذي يرسله كل تحكم تلقائي في Marrow، والمعروض في مرجع التحكم التلقائي:
{"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 (طويل) في التنسيق، ثم اضغط إنشاء تصدير.
- شارك الملف إلى Google Drive.
- في Sheets، افتح File، ثم Import، واختر الملف.
في CSV صف لكل يوم وعمود لكل مقياس. وCSV (طويل) هو date,metric,value,unit، وهو الشكل الذي يريده الجدول المحوري. كل ملف موصوف في مرجع الملفات.
إذا لم يعمل
- لا صفوف بعد تشغيل الآن. افتح مشروع Apps Script وانقر Executions على اليسار. يظهر كل طلب POST هناك مع أي خطأ.
- تم التسليم، لكن لا صفوف. تجيب الوصفة بـ forbidden عندما لا يطابق
?key=قيمةSECRETفيها، ومع ذلك يرى Marrow نجاحًا. تحقق من المفتاح في نهاية العنوان. - تعديلات السكربت لا تفعل شيئًا. اذهب إلى Deploy، ثم Manage deployments، وعدّل النشر النشط، واختر إصدارًا جديدًا ثم Deploy. يبقى العنوان
/execيشغّل الإصدار القديم حتى تفعل ذلك. - العنوان ينتهي بـ /dev. هذا لا يعمل إلا لمن لديهم صلاحية التعديل وسجّلوا الدخول. يحتاج Marrow إلى العنوان
/exec. - السكربت لا يعمل أبدًا. في النشر، يجب أن يسمح Who has access لأي أحد بالوصول دون تسجيل الدخول.
- الملف المستورد يظهر عمودًا واحدًا طويلًا. استورده مجددًا واختر الفاصلة فاصلًا.
- التشغيل يتأخر. يختار iOS لحظة العمل في الخلفية، والهاتف الذي يبقى مقفلًا يرسل عند فتحه التالي. تشرح صفحة متى يعمل التحكم التلقائي ما يمكن توقعه.
أسئلة
هل هو مجاني؟
نعم. التحكم التلقائي وتصدير الملفات جزء من خطة Marrow المجانية، وApps Script مجاني مع حساب Google. والتحكم التلقائي المشغّل يُحتسب واحدًا من الاتصالات الثلاثة في الخطة المجانية.
هل يتحدّث الجدول والتطبيق مغلق؟
نعم. يعمل التحكم التلقائي في الخلفية في اللحظات التي يسمح بها iOS، عادة عدة مرات في اليوم.
إلى أي مدى يعود في الماضي؟
إلى أبعد ما قرأه Marrow. وهو افتراضيًا ثلاث سنوات من سجل Apple Health، ويمدّه الإعدادات، أنواع البيانات، سجل Apple Health إلى خمس سنوات، أو كل شيء، أو من تاريخ تختاره. للتحميل الأول، اضبط نطاق تاريخ التحكم التلقائي تحت خيارات إضافية، وشغّله مرة، ثم أعده إلى منذ آخر تشغيل.
هل تستطيع Google رؤية بياناتي الصحية؟
تعيش الصفوف في جدول Google الخاص بك، وفق شروط حساب Google لديك. يرسلها Marrow من هاتفك إلى سكربتك ولا يحتفظ بأي نسخة على خادم لدينا.
طرق أخرى لفعل ذلك، ومتى تختارها
- Health Auto Export يحفظ ملفات CSV في Google Drive حسب جدول مع فئة Premium. اختره إذا كان مجلد ملفات في Drive هو ما تريده، أو إذا كنت تستخدم أيضًا تطبيقيه على Mac وiPad. التفاصيل في مقارنتنا.
- n8n أو Zapier أو Make. أرسل إلى webhook ودع الأداة تضيف الصفوف بخطوة Google Sheets الخاصة بها. اختر هذا إذا كنت تستخدم إحداها أصلًا ولا تريد صيانة سكربت. الخطوات: n8n، Zapier، Make.
- ملف export.zip من Apple. لسجلك كله مرة واحدة، صدّر من تطبيق Health، وحوّله إلى CSV بـ محوّلنا في متصفحك، واستورد الملفات. إنه لقطة ثابتة، فالبيانات الجديدة تعني تصديرًا جديدًا.
- اختصارات Apple تستطيع إرسال بضع عيّنات صحية إلى تطبيق الويب نفسه. اخترها لرقم أو اثنين يوميًا إذا لم تمانع بناء كل واحد بنفسك.
ذو صلة: Apple Health إلى CSV · Apple Health إلى webhook · مرجع التحكم التلقائي