إنشاء خلاصة

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

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

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

  • يجب أن يتضمّن ملف الخلاصة الإضافة .json في اسم الملف.
  • لا تشفِّر ملف الخلاصة.
  • رمزِّر ملف الخلاصة بترميز UTF-8 (تحقّق من إعدادات محرِّر الملفات).

    alt_text

  • قسِّم الملف إلى عدة ملفات إذا كان حجم ملف الخلاصة أكبر من 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. استخدِم أداة التحقّق من صحة خلاصة البيانات للتحقق من أخطاء البنية والخصائص المطلوبة غير المتوفّرة. (يُرجى الاطّلاع على القسم التالي لمعرفة التفاصيل).
    {
      "@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 التحقّق من جميع الملفات في خلاصة. استخدِم هذه الأداة أثناء تطوير الخلاصة لتجنُّب الأخطاء الهيكلية الشائعة. يمكنك الاطّلاع على مزيد من التفاصيل حول الأداة هنا.

إنشاء خلاصة علنية

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