تحديد المشاكل وحلّها

يوضّح هذا الدليل كيفية تحديد المشاكل الشائعة وحلّها عند استخدام Google Health API.

أخطاء العميل 4xx

يتم عرض رموز الحالة 4xx عند حدوث مشكلة في رمز تطبيق العميل. راجِع عناصر نص الردّ للحصول على مزيد من المعلومات حول المشكلة.

‫400 طلب غير صالح

رسالة	الوصف	الاقتراح
يحتوي الطلب على وسيطة غير صالحة.	معرّف نوع البيانات {value} غير متوافق.	تأكَّد من أنّ نقطة النهاية تتوافق مع نوع البيانات الذي تتم الإشارة إليه.
تم تلقّي حِمل JSON غير صالح. الأرقام الثمانية/السداسية العشرية ليست قيم JSON صالحة.		لا تتيح نقطة نهاية dailyRollUp استخدام قيم الشهر واليوم الممثّلة بتنسيق MM أو DD على التوالي. يجب ألا تتضمّن الأرقام الفردية صفرًا في البداية.
رقم المشروع غير صالح في اسم المورد	عند حذف مشترك أو تعديله باستخدام رقم تعريف مشروع Google Cloud في عنوان URL للطلب بدلاً من رقم المشروع ينطبق ذلك على الاشتراكات في خطافات الويب باستخدام نقطة النهاية projects.subscribers.	استخدِم رقم مشروع Google Cloud في عنوان URL للطلب، وليس رقم تعريف المشروع.

‫401 غير مصرّح به

رسالة	الوصف	الاقتراح
تضمّن الطلب بيانات اعتماد مصادقة غير صالحة. يجب توفّر رمز دخول متوقّع عبر OAuth 2 أو ملف تعريف ارتباط لتسجيل الدخول أو بيانات اعتماد أخرى صالحة للمصادقة.	INVALID_AUTHENTICATOR: انتهت صلاحية الرمز المميز	انتهت صلاحية رمز الدخول. استخدِم الرمز المميز لإعادة التحميل للحصول على رمز دخول مميز جديد ورمز إعادة تحميل جديد، أو يجب أن يوافق المستخدم مجددًا على التطبيق.

‫403 Forbidden

رسالة	الوصف	الاقتراح
ليس لدى المتصل إذن	عند إنشاء مشتركين أو إدراجهم باستخدام رقم تعريف مشروعك على Google Cloud في عنوان URL للطلب بدلاً من رقم المشروع ينطبق ذلك على الاشتراكات في خطافات الويب باستخدام نقطة النهاية projects.subscribers.	استخدِم رقم مشروع Google Cloud في عنوان URL للطلب، وليس رقم تعريف المشروع.
ليس لدى المتصل إذن.	تعذّر إنشاء UberMint من GaiaMint.	تمكّن المستخدم من إكمال عملية التفويض، ولكن تعذّر تنفيذ طلب نقطة النهاية. يمكن أن يحدث ذلك عندما يوافق حساب Fitbit قديم على التطبيق بدلاً من حساب Google. لحلّ هذا الخطأ، اتّبِع الخطوات التالية: سجِّل الخروج من تطبيق Fitbit للأجهزة الجوّالة من خلال إعدادات Fitbit. سجِّل الدخول إلى تطبيق Fitbit للأجهزة الجوّالة من خلال النقر على الزر "متابعة باستخدام حساب Google" أو "تسجيل الدخول باستخدام حساب Google". إذا تلقّيت رسالة تفيد بأنّه "لا يمكن استخدام Fitbit مع حساب Google هذا"، يعني ذلك أنّ عنوان بريدك الإلكتروني لا يزال مسجّلاً كحساب قديم على Fitbit. اتّبِع الخطوات الواردة في مقالة المساعدة هذه لنقل حسابك.

‫404 لم يتم العثور على الصفحة

رسالة	الوصف	الاقتراح
تعذّر العثور على عنوان URL المطلوب /v4/users/me/dataTypes/{dataType}/dataPoints على هذا الخادم.		الأسباب المحتملة: التأكّد من استخدام الفعل الصحيح التحقّق من بنية نقطة النهاية بحثًا عن أخطاء إملائية

استرداد رقم تعريف مستخدم Fitbit

للمساعدة في تحديد المشاكل التي يواجهها المستخدم وحلّها، قد تحتاج إلى إثبات ملكية حساب Google الذي سجّل المستخدم الدخول منه إلى تطبيق Fitbit للأجهزة الجوّالة.

للعثور على معرّف مستخدم Fitbit، اتّبِع الخطوات التالية:

1. افتح تطبيق Fitbit للأجهزة الجوّالة.
2. انقر على رمز أنت في أسفل يسار الشاشة.
3. انقر على الرابط تعديل الملف الشخصي في المربّع العلوي الذي يتضمّن اسم المستخدم وتاريخ الانضمام.
4. انتقل إلى أسفل الصفحة. في القسم حسابك، القيمة المخصّصة لرقم التعريف هي رقم تعريف مستخدم Fitbit. (على سبيل المثال: CV5TKH)

إلغاء الموافقة على تطبيق

عند مساعدة مستخدم في تحديد المشاكل وحلّها بشأن ربط حسابه بتطبيقك باستخدام OAuth2، قد تحتاج إلى أن يزيل ربط حسابه بتطبيقك ثم يكمل مسار التفويض مرة أخرى.

لإلغاء ربط حساب Google بتطبيقك، اتّبِع الخطوات التالية:

1. افتح تطبيق Fitbit للأجهزة الجوّالة.
2. اضغط على رمز الملف الشخصي لمستخدم Fitbit في أعلى يسار الشاشة.
3. انقر على إدارة حساب Google.
4. انقر على المربّع البيانات والخصوصية.
5. انتقِل إلى قسم **بيانات من تطبيقات وخدمات يتم استخدامها. ضمن التطبيقات والخدمات، انقر على التطبيقات والخدمات الخارجية.
6. ابحث عن اسم تطبيقك في قائمة التطبيقات المرتبطة، واطلب من المستخدم اختياره.
7. انقر على إلغاء كل عمليات الربط بين حسابك و <اسم التطبيق>.
8. اطلب من المستخدم الضغط على "تأكيد" لإلغاء الموافقة على تطبيقك.

عند اكتمال عملية الإبطال، سيتم إعادة توجيه المستخدم إلى قائمة صفحة التطبيقات والخدمات التابعة لجهات خارجية. قد يحتاج المستخدم إلى إعادة تحميل الصفحة للاطّلاع على اسم التطبيق الذي تمت إزالته من القائمة.

تحديد المشاكل المتعلقة بتأخُّر مزامنة الأجهزة وحلّها

عند تصحيح الأخطاء المتعلّقة ببيانات المستخدمين الناقصة أو المتأخّرة، من المفيد التحقّق من طراز الجهاز المقترن بالمستخدم وتاريخ آخر مزامنة.

تكون معلومات الطراز (مثل طراز جهاز تتبُّع Fitbit أو ساعة ذكية) وتاريخ آخر مزامنة مفيدة لتحديد المشاكل وحلّها ولجلب البيانات السابقة بعد حدوث تأخيرات في المزامنة.

على سبيل المثال، إذا لاحظت فجوة أو تأخيرًا غير متوقّع في تسليم البيانات:

1. تأكَّد من أنّ رقم تعريف المستخدم الذي تبحث عنه يطابق رقم تعريف حساب Fitbit المسجّل الدخول إليه في التطبيق المتوافق مع الأجهزة الجوّالة. للحصول على رقم تعريف المستخدم في التطبيق المتوافق مع الأجهزة الجوّالة، اطّلِع على استرداد رقم تعريف مستخدم Fitbit. للحصول على رقم تعريف المستخدم من رمز الدخول، اتّصِل بنقطة النهاية getIdentity.
2. تحقَّق من وقت آخر مزامنة لتحديد آخر مرة تمت فيها مزامنة جهاز المستخدم مع تطبيق &quot;Google Health&quot; للأجهزة الجوّالة.
3. إذا لم تتم مزامنة الجهاز مؤخرًا، يشير ذلك إلى أنّ التأخير يرجع على الأرجح إلى أنّ الجهاز غير متصل بالإنترنت أو لا تتم مزامنته مع تطبيق الأجهزة الجوّالة، وليس إلى مشكلة في واجهة برمجة التطبيقات.
4. بعد أن يفتح المستخدم تطبيق الأجهزة الجوّالة ويُجري مزامنة لجهازه، يمكنك استرداد البيانات السابقة للفترة منذ آخر وقت تمت فيه المزامنة.

لاسترداد معلومات جهاز مقترن خاص بمستخدم، يمكنك استدعاء نقطة النهاية users.pairedDevices.list. يعرض هذا الإجراء قائمة بالأجهزة التي تتضمّن ما يلي:

• deviceVersion: اسم المنتج أو طراز الجهاز (مثلاً، "Charge 6").
• lastSyncTime: الطابع الزمني لآخر عملية مزامنة ناجحة.