إنشاء خلاصة

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

متطلبات تنسيق ملف الخلاصة

في ما يلي متطلبات ملفات الخلاصة:

• يجب أن يتضمّن ملف الخلاصة الإضافة .json في اسم الملف.
• لا تشفِّر ملف الخلاصة.

• ترميز ملف الخلاصة بتنسيق UTF-8 (تحقَّق من إعدادات محرِّر الملفات)

  

• قسِّم الملف إلى ملفات متعددة إذا كان حجم ملف الخلاصة أكبر من 1 غيغابايت (غير مضغوط).

• ننصحك بإنشاء ملف لكل نوع من أنواع الكيانات (على سبيل المثال، tvseries.json وtvseasons.json وtvepisodes.json وmovies.json وما إلى ذلك).

  • إذا تجاوز حجم أيّ من هذه الملفات 1 غيغابايت، يجب تقسيم عناصره إلى ملفات متعددة (مثلاً، tvepisodes_01.json وtvepisodes_02.json وما إلى ذلك).
  • طالما أنّ حجم الملف أقل من 1 غيغابايت، ليس هناك حدّ أقصى لعدد الكيانات التي يمكنك تضمينها في ملف واحد.

• تأكَّد من ترميز الملف بدون علامة ترتيب بايت (BOM)، وفقًا لمواصفات JSON. للتحقّق من نظام التشغيل Linux، يجب ألا يبدأ hexdump file.json | head -n 1 بـ BBEF في العنوان 0x00.

أنواع الخلاصات

خلاصة الإنتاج

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

خلاصة مرحلية

• هناك حالات استخدام معيّنة تتطلّب توسيع خلاصة الإنتاج. في ما يلي بعض الأمثلة على هذه السيناريوهات:
  • توسيع الخلاصة لتشمل أنواع كيانات جديدة لم يتم إطلاقها سابقًا
  • توسيع الخلاصة لتشمل عددًا كبيرًا من الكيانات أو البيانات الوصفية الجديدة لإطلاقها في مناطق جديدة
  • توسيع نطاق الخلاصة لتشمل أنواعًا جديدة من المنصات على سبيل المثال، عندما يتم إطلاق خلاصة الإنتاج على "بحث Google" فقط وتريد الآن توسيع نطاق الإطلاق ليشمل Google TV.
• وفي هذه الحالات، يجب توفير خلاصة مرحلية. هذه الخلاصة هي نسخة من خلاصة الإنتاج، ولكنّها تتضمّن بيانات وصفية إضافية، مثل الروابط لصفحات معيّنة لمنصة جديدة والبيانات الوصفية لإعدادات محلية جديدة وما إلى ذلك.
• على غرار خلاصة الإنتاج، سيتم تحليل هذه الخلاصة بشكل مكثّف وتكرارها عدة مرات لتحقيق مستوى جودة أعلى في ما يتعلق بكمية المعلومات التي يتم تسجيلها وصحتها. بعد استيفاء معايير الجودة، تحلّ هذه الخلاصة محلّ خلاصة الإنتاج الحالية لتصبح خلاصة الإنتاج الجديدة.
• تتيح لنا هذه الخلاصة فصل عملية الإطلاق الأولية عن عمليات الإطلاق الإضافية وإجراء جميع الاختبارات المطلوبة بدون التأثير في خلاصة الإنتاج. يضمن ذلك عدم حدوث أي انقطاع في تجربة المستخدم النهائي.

يُرجى التواصل مع ممثل عن Google لتوضيح أي أسئلة قد تكون لديك حول ما سبق.

إنشاء ملف خلاصة

اتّبِع أفضل الممارسات التالية عند إنشاء الخلاصة:

1. إنشاء نموذج خلاصة باستخدام مجموعة صغيرة من الكيانات

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

2. التحقّق من صحة الخلاصة النموذجية

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

3. إنشاء خلاصة المنتجات

   بعد التأكّد من أنّ لديك بنية جيدة لمجموعة صغيرة من الكيانات، يمكنك إنشاء خلاصة للكتالوج بأكمله.

إنشاء خلاصة نموذجية

1. اختَر كيانًا تمثيليًا واحدًا من الكتالوج. اختَر كيانًا ببنية معقّدة إلى حدّ ما، ولكنّه لا يزال يمثّل كيانًا في الكتالوج.
2. استخدِم أداة التحقّق من صحة مخطط JSON للبحث عن أخطاء في البنية وخصائص مطلوبة غير متوفّرة. (يُرجى الاطّلاع على القسم التالي لمعرفة التفاصيل).

   مثال على خلاصة تتضمّن كيان Movie واحد

   {
     "@context": "http://schema.org",
     "@type": "DataFeed",
     "dateModified": "2018-07-20T00:44:51Z",
     "dataFeedElement": [
       {
         "@context": ["http://schema.org", {"@language": "en"}],
         "@type": "Movie",
         "@id": "http://www.example.com/my_favorite_movie",
         "url": "http://www.example.com/my_favorite_movie",
         "name": "My Favorite Movie",
         "potentialAction": {
           "@type": "WatchAction",
           "target": {
             "@type": "EntryPoint",
             "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
             "inLanguage": "en",
             "actionPlatform": [
               "http://schema.org/DesktopWebPlatform",
               "http://schema.org/MobileWebPlatform",
               "http://schema.org/AndroidPlatform",
               "http://schema.org/AndroidTVPlatform",
               "http://schema.org/IOSPlatform",
               "http://schema.googleapis.com/GoogleVideoCast"
             ]
           },
           "actionAccessibilityRequirement": {
             "@type": "ActionAccessSpecification",
             "category": "subscription",
             "requiresSubscription": {
               "@type": "MediaSubscription",
               "name": "Example Package",
               "commonTier": true,
               "@id": "[partner determined string]"
             },
             "availabilityStarts": "2018-07-21T10:35:29Z",
             "availabilityEnds": "2019-10-21T10:35:29Z",
             "eligibleRegion": [
               {
                 "@type": "Country",
                 "name": "US"
               },
               {
                 "@type": "Country",
                 "name": "CA"
               }
             ]
           }
         },
         "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
         "releasedEvent": {
           "@type": "PublicationEvent",
           "startDate": "2008-01-20",
           "location": {
             "@type": "Country",
             "name": "US"
           }
         },
         "description": "This is my favorite movie.",
         "actor": [
           {
             "@type": "Person",
             "name": "John Doe",
             "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
           },
           {
             "@type": "Person",
             "name": "Jane Doe",
             "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
           }
         ],
         "identifier": [
           {
             "@type": "PropertyValue",
             "propertyID": "IMDB_ID",
             "value":  "tt0123456"
           }
         ]
       }
     ]
   }

التحقّق من صحة الخلاصة النموذجية

تتوفّر الأدوات التالية لمساعدتك في التحقّق من صحة نموذج خلاصة وفقًا لمواصفات البيانات المنظَّمة من Google لخلاصات الوسائط:

• أداة التحقّق من صحة مخطط JSON

  تتحقّق أداة JSON Schema Validation من صحة جميع الملفات في الخلاصة محليًا قبل تحميلها. استخدِم هذه الأداة أثناء تطوير الخلاصة لتجنُّب الأخطاء الشائعة في البنية والنوع. يمكنك الاطّلاع على المزيد من التفاصيل حول الأداة هنا.

• مواقع الكتالوجات الإلكترونية على Search Console

  بعد أن يفعّل ممثل عن Google موقعك الإلكتروني في كتالوج Search Console ويتم استيراد خلاصتك النموذجية أو التجريبية، استخدِم مواقع الكتالوج الإلكترونية على Search Console لفحص أخطاء التحقّق والتحذيرات وبيانات تشخيص الاستيراد على مستوى الكيان.

إنشاء خلاصة المنتجات

1. بعد حلّ جميع الأخطاء والتحذيرات البنيوية في الخلاصة النموذجية، يمكنك توسيع الخلاصة لتشمل جميع الكيانات في الكتالوج.
2. شغِّل أداة التحقّق من صحة مخطط JSON على ملفات الخلاصة الموسّعة وراجِع مواقع الكتالوج الإلكترونية على Search Console بعد التحميل للتأكّد من عدم وجود أخطاء في التحقّق من الصحة. تأكَّد من أنّ خلاصتك تتضمّن جميع العناصر في الكتالوج من خلال مقارنة عدد العناصر في خلاصتك بعدد العناصر في الكتالوج.