مدقق بيانات الفيديو VideoObject

الصق JSON-LD الذي يصف فيديو، وستفحصه الأداة وفق جداول الخصائص في وثائق Google عن البيانات المنظَّمة للفيديو. تعمل في متصفحك بدالة JSON.parse، ولا يُرسل أي شيء تلصقه إلى أي مكان.

ماذا تفحص الأداة؟#

• عقدة VideoObject: قد يكون المُدخل كائنًا واحدًا أو مصفوفة أو كائنًا فيه قائمة @graph. وتستخدم الأداة أول عقدة قيمة @type فيها VideoObject.
• الخصائص الثلاث المطلوبة: توثّق Google name وthumbnailUrl وuploadDate كخصائص مطلوبة. name عنوان الفيديو، وتطلب Google أن يكون فريدًا لكل فيديو في الموقع.
• معنى الخاصيتين الأخريين: thumbnailUrl تشير إلى الصورة المصغّرة للفيديو، وuploadDate هي تاريخ نشر الفيديو أول مرة.
• ثماني خصائص مقترحة: contentUrl وembedUrl وdescription وduration وcreator وinteractionStatistic وexpires وregionsAllowed، وتظهر كل منها موجودة أو مفقودة. وتقبل Google الخاصية author بدل creator، فأيهما يُحسب.
• شكل creator: توثّق Google الخاصية creator (أو author) ككائن Person أو Organization. والقيمة النصية العادية تأخذ تحذيرًا، وكذلك كائن Person أو Organization بلا name ولا alternateName، لأن Google تشترط تقديم أحدهما.
• قيم interactionStatistic: يُفحص كل عدّاد، كائنًا واحدًا أو مصفوفة، لقيمة interactionType تدعمها Google: WatchAction أو LikeAction أو CommentAction أو ShareAction، ولقيمة userInteractionCount تكون عددًا صحيحًا.
• الخاصية القديمة: قيمة interactionCount بلا interactionStatistic تأخذ سطر معلومة، لأن Google توصي بالخاصية الأحدث.
• صيغة uploadDate: يجب أن تكون تاريخًا أو تاريخًا ووقتًا بصيغة ISO 8601، كما في مثال Google 2024-03-31T08:00:00+08:00. والتاريخ والوقت بلا منطقة زمنية يأخذ ملاحظة إضافية، لأن Google توصي بها وإلا افترضت المنطقة الزمنية لـ Googlebot.
• صيغة duration: يجب أن تكون مدة بصيغة ISO 8601. ومثال Google هو PT1M54S، أي دقيقة وأربع وخمسون ثانية.
• طريقة للعثور على الفيديو: إذا غابت contentUrl وembedUrl معًا، تحذّر الأداة. تصف Google الخاصية contentUrl بأنها أكثر الطرق فعالية لجلب ملف الفيديو، وembedUrl بأنها البديل حين لا يتوفر عنوان الملف.

كيف تقرأ النتائج؟#

يحمل كل سطر واحدة من أربع علامات.

• مشكلة: لا عقدة VideoObject، أو خاصية مطلوبة مفقودة، أو uploadDate ليست تاريخ ISO 8601 صالحًا. أصلِح هذه أولًا.
• تحذير: قيمة duration ليست مدة ISO 8601، أو لا contentUrl ولا embedUrl، أو creator ليست Person أو Organization لها اسم، أو interactionType غير مدعومة، أو userInteractionCount ليست عددًا صحيحًا.
• معلومة: خاصية مقترحة مفقودة، أو وقت في uploadDate بلا منطقة زمنية، أو interactionCount قديمة.
• ناجح: الخاصية موجودة أو الصيغة صالحة.

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

مثال عملي#

يقع هذا الترميز داخل @graph مع عقدة WebPage:

{
  "@type": "VideoObject",
  "name": "Canonical tags explained",
  "uploadDate": "2026-09-01T08:00:00",
  "duration": "2:10",
  "embedUrl": "https://example.com/embed/42"
}

تعثر الأداة على عقدة VideoObject وتعرض:

السطر	النتيجة
thumbnailUrl	مفقودة، مشكلة
uploadDate بصيغة ISO 8601	ناجح
uploadDate تحمل منطقة زمنية	معلومة
duration مدة بصيغة ISO 8601	2:10، تحذير
contentUrl وdescription وcreator وinteractionStatistic وexpires وregionsAllowed	مفقودة، معلومة

تنجح name وuploadDate وembedUrl وduration في فحص الوجود. وإضافة thumbnailUrl، وكتابة التاريخ 2026-09-01T08:00:00+00:00 والمدة PT2M10S، تزيل كل مشكلة وكل تحذير.

وتكفي embedUrl وحدها لفحص contentUrl أو embedUrl، فلا يظهر تحذير عنه.

أخطاء شائعة تكشفها#

• لا صورة مصغّرة: thumbnailUrl مطلوبة، لذلك يظهر غيابها كمشكلة لا كاقتراح.
• مدد بصيغة الساعة: 2:10 أو 130 بدل PT2M10S.
• تواريخ بلا منطقة زمنية: صيغة ISO 8601 صالحة، لكن Google تفترض حينها المنطقة الزمنية لـ Googlebot.
• تواريخ ليست ISO: قيمة مثل 01/09/2026 تفشل في فحص uploadDate.
• creator كنص مجرد: "creator": "Jane Doe" بدل كائن Person له اسم.
• أنواع تفاعل غير مدعومة: عدّاد ViewAction، بينما توثّق Google WatchAction للمشاهدات.
• لا طريق إلى الفيديو: لا contentUrl ولا embedUrl، فلا تملك Google عنوانًا للفيديو نفسه.

ما لا تفحصه الأداة#

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

أدوات ومقالات ذات صلة#

• أداة التحقق من صياغة JSON-LD وحقوله المطلوبة
• مولّد البيانات المنظَّمة للبحث والذكاء الاصطناعي
• خصائص VideoObject المطلوبة التي توثّقها Google فعلًا
• Italiaonline: نمو نقرات الفيديو 841% بعد إصلاح البيانات المنظَّمة