كيفية التحقق من البيانات المنظّمة JSON-LD في صفحة ويب
تحقّق من JSON-LD في أي صفحة ويب بحثًا عن الأخطاء والحقول الناقصة، واعرض كل عنصر schema.org تصفه الصفحة، واقرأ JSON لكل كتلة.
دقيقتان للقراءة
للتحقق من JSON-LD في صفحة ويب، افتح أداة التحقق من JSON-LD، والصق عنوان الصفحة، ثم انقر على "جلب JSON-LD والتحقق منه". تسرد النتيجة كل مشكلة، وكل عنصر تصفه الصفحة، وJSON لكل كتلة. إذا لم تكن هناك مشكلات في الصفحة، يظهر الملخص باللون الأخضر.
كيفية التحقق من صفحة
- افتح الصفحة في متصفحك وانسخ العنوان من شريط العناوين.
- الصقه في حقل URL. إذا لم يتضمن العنوان
https://، فستُضاف تلقائيًا. - انقر على "جلب JSON-LD والتحقق منه".
- اقرأ الملخص الذي يظهر فوق الجداول. فهو يبيّن عدد الكتل والأخطاء والتحذيرات.
- اختر كتلة ضمن «المصدر» لعرض JSON الخاص بها مع أرقام الأسطر.
كيفية قراءة النتيجة
- يسرد جدول المشكلات كل خطأ وتحذير. ولا يظهر إلا عند وجود مشكلة.
- «الكتلة» هي رقم كتلة البرنامج النصي، بحسب ترتيبها من أعلى الصفحة.
- يوضّح «الموضع» مكان المشكلة، مثل
Product.image. - يسرد جدول العناصر كل عنصر ونوعه، مثل Article أو Product، واسمه.
- انقر على عنوان عمود لفرز الجدول. تصدّر الأزرار أسفل كل جدول بياناته بصيغة CSV أو JSON.
المشكلات التي ينبغي إصلاحها أولًا
تظهر الأخطاء أولًا في القائمة، وعليها علامة حمراء. أما التحذيرات فعليها علامة صفراء. يعني الخطأ وجود خلل أو غياب حقل مطلوب. أما التحذيرات المعلّمة بعبارة «(اختياري)» فتشير إلى حقول يمكنك إضافتها عند توفر البيانات.
يمكن إصلاح هذه الرسائل بسهولة.
| الرسالة | الحل |
|---|---|
| JSON غير صالح | ابحث عن فاصلة أو علامة اقتباس مفقودة، أو عن فاصلة بعد القيمة الأخيرة. |
@context مفقود؛ أضف "@context": "https://schema.org" |
أضف هذا السطر إلى الكتلة. |
| @type مفقود | أضف نوعًا، مثل "@type": "Product". |
| "@Type" ليس كلمة مفتاحية في JSON-LD | اكتب الكلمات المفتاحية بأحرف صغيرة: @type. |
| النوع "Organisation" ليس نوعًا صالحًا في schema.org | استخدم الاسم الدقيق في schema.org، وهو هنا Organization. |
| السمة المطلوبة "image" مفقودة | أضف الحقل المذكور في الرسالة. |
عندما لا يعثر الفحص على شيء أو يفشل
تعني رسالة "لم يتم العثور على كتل نصوص برمجية JSON-LD في هذه الصفحة" أن HTML الصفحة لا يحتوي على JSON-LD. يفحص التحقق الصفحة كما يرسلها الخادم. ولن يعثر على JSON-LD الذي يضيفه نص برمجي لاحقًا في المتصفح.
تعني رسالة "تعذّر جلب الصفحة" أن الموقع لم يرسل الصفحة. ويحدث هذا أيضًا عندما يعيد العنوان التوجيه إلى عنوان آخر، لأن عمليات إعادة التوجيه لا تُتبع. انسخ العنوان النهائي من شريط العناوين وحاول مرة أخرى.
يُفحص أول 3 MB فقط من الصفحة. وستظهر رسالة إذا كان حجم الصفحة أكبر من ذلك.
أصلح الأخطاء، وحدّث الصفحة، ثم أجرِ الفحص مرة أخرى.
هل أنت مستعد لتجربتها بنفسك؟
مدقّق JSON-LD
أدخل عنوان URL، وسيجلب الخادم الصفحة ويستخرج كل كتلة من بيانات JSON-LD المنظّمة، ثم يتحقق من أخطاء صياغة JSON، وغياب @context و@type، وأنواع وخصائص schema.org غير المعروفة، والحقول التي تحتاج إليها Google للنتائج المنسّقة.