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

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

أخطاء 4xx من جانب العميل

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

400 طلب غير صالح

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

الخطأ 401: غير مصرّح به

رسالة الوصف الاقتراح
تضمّن الطلب بيانات اعتماد غير صالحة للمصادقة. كان من المتوقّع توفّر رمز دخول OAuth 2 أو ملف تعريف ارتباط لتسجيل الدخول أو بيانات اعتماد أخرى صالحة للمصادقة. INVALID_AUTHENTICATOR: Token expired (المصادقة غير صالحة: انتهت صلاحية الرمز المميّز) انتهت صلاحية رمز الدخول المميز. يُرجى استخدام الرمز المميز لإعادة التحميل للحصول على رمز دخول ورمز مميز جديدَين لإعادة التحميل، أو على المستخدم إعادة منح الموافقة للتطبيق.

403 Forbidden

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

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

  1. يُرجى تسجيل الخروج من تطبيق Fitbit للأجهزة الجوّالة من خلال إعدادات Fitbit.
  2. يُرجى تسجيل الدخول إلى تطبيق 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. اطلب من المستخدم النقر على "تأكيد" لإبطال الموافقة على تطبيقك.

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