خصائص ترميز المحتوى لـ MediaService (مطلوبة)

يقدم هذا القسم تفاصيل سمات ترميز المحتوى لنوع الكيان MediaService الذي يلتقط إعدادات دمج إجراءات الوسائط.

جدول المواصفات

الخاصية النوع المتوقّع الوصف
@type Text

مطلوبة - يتم ضبطها دائمًا على MediaService.

@context Text

مطلوبة - يتم ضبطها دائمًا على ["http://schema.org", {"@language": "xx"}].

@id URL

مطلوبة: معرّف فريد لعلامتك التجارية، على سبيل المثال، https://example.com.

ويجب أن يلتزم المعرّف بالمتطلبات التالية:

  • وهي فريدة عالميًا في الكتالوج الخاص بك.
  • الثابت. ويجب أن يكون المعرّف ثابتًا ولا يتغيّر بمرور الوقت.
  • يجب أن يكون بتنسيق المعرِّف الموحَّد (URI).
  • ويجب أن تمتلك نطاقه مؤسستك.
name Text

مطلوبة: اسم مقدّم الخدمة.

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

brandIcon ImageObject

مطلوبة لكل إجراءات المشاهدة وإجراءات الاستماع: ملف الصورة الذي يحمل رمز علامتك التجارية والمكرّر لكل حجم في نتيجة الإجراء "مشاهدة/الاستماع"، تربط Google الروابط لصفحات المحتوى الخاصة بك برمز علامتك التجارية.

يجب أن يتقيد ملف صورة رمز العلامة التجارية بالمتطلبات التالية:

  • إنه ملف PNG.
  • خلفيتها شفافة.
  • شكله مستدير بطبيعته.
  • تأكَّد من أنّ الصور مضادة للأسماء المستعارة وليست مشوّهة/تقطيع

يجب تكرار هذه السمة، لأنّه عليك تقديم خمس صور، لكلٍّ من السمات التالية:

  • 16×16 بكسل، مع ملف لا يزيد حجمه عن 1 كيلوبايت
  • 20×20 بكسل، بحجم ملف لا يزيد عن 1 كيلوبايت
  • 40x40 بكسل، ولا يزيد حجم الملف عن 1 كيلوبايت
  • 44x44 بكسل، بحجم ملف لا يزيد عن 1 كيلوبايت
  • 112×112 بكسل، ولا يزيد حجم الملف عن 3 كيلوبايت

متطلبات إضافية لدمج Google TV: سيتم عرض هذه الصور التي تحمل رمز علامتك التجارية في أعلى دليل البرمجة وعلى أزرار إجراءات المشاهدة وفي إعدادات Google TV. يُرجى تقديم ثلاثة رموز تستوفي المتطلبات التالية:

  • رمز مربّع واحد بتنسيق ملف PNG (بدقة 512x512 بكسل، بنسبة عرض إلى ارتفاع تبلغ 1:1)
  • رمز علامة نصية بيضاء واحد بتنسيق ملف PNG (أعلى درجة دقة متاحة، وليس هناك إعداد مفضّل لنسبة العرض إلى الارتفاع)
  • رمز شعار نصي واحد ملوّن بتنسيق ملف PNG (أعلى درجة دقة متاحة، وليس هناك إعداد مفضّل لنسبة العرض إلى الارتفاع)

تأكَّد من أنّ الصور مضادة للأسماء المستعارة وليست مشوّهة/تقطيع.

brandIcon.contentURL URL

مطلوبة - عنوان URL للصورة

brandIcon.height Number

مطلوبة - ارتفاع الصورة بالبكسل.

brandIcon.width Number

مطلوبة - عرض الصورة بالبكسل.

brandIcon.additionalProperty PropertyValue

مطلوبة - هي سمة إضافية تُستخدَم لوصف نوع الصورة وتحدّد الاستخدامات المقصودة لها.

brandIcon.additionalProperty.@type Text

مطلوبة - تم ضبط الإعدادات على PropertyValue

brandIcon.additionalProperty.name Text

مطلوبة - تم ضبط الإعدادات على contentAttributes

brandIcon.additionalProperty.value Text

مطلوبة: مدى الملاءمة للخلفية

لتكون صالحًا، اضبط القيمة التالية على الأقل على القيم التالية:

  • forDarkBackground: صورة عادةً ما تكون رمزًا شفافًا، وهو مناسب للاستخدام على خلفية داكنة.
  • forLightBackground: صورة، تكون عادةً رمزًا شفافًا، مناسبة للاستخدام على خلفية فاتحة.
application SotkwreApplication

مطلوب في حال تقديم تطبيقات iOS أو Android أو Cast أو AndroidTV - قائمة بتطبيقات علاماتك التجارية في ما يلي:

  • iOS
  • Android
  • Cast
  • تلفزيون Android
application.@type Text

مطلوبة - يتم ضبطها دائمًا على SoftwareApplication.

application.operatingSystem Text

مطلوبة - يتم ضبطها على أي مما يلي:

  • iOS
  • Android
  • Cast
  • AndroidTV
application.downloadUrl URL

مطلوب إذا كان ذلك منطبقًا - بالنسبة إلى الأنظمة الأساسية Android وAndroidTV وiOS، عليك تحديد ذلك كرابط للتطبيق في App Store و"متجر Play".

بالنسبة إلى جميع الأنظمة الأساسية الأخرى، لا يُعدّ هذا الموقع مطلوبًا.

application.installUrl URL

مطلوب إذا كان ذلك منطبقًا: إذا كان مقدّم الخدمة يوفر تشغيل الوسائط من خلال تطبيق AndroidTV، يجب تحديد ذلك كرابط إلى ملف AndroidTV APK.

هذه السمة غير مطلوبة في حال لم يوفّر مقدّم الخدمة تشغيل AndroidTV.

application.identifier

Text

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

  • iOS: معرّف تطبيق App Store مثلاً: 967093455
  • Android: اسم حزمة Android في "متجر Play". مثلاً: com.abc.media.android
  • البثّ: معرِّف تطبيق البث مثلاً: ACDA4FDE
  • AndroidTV: اسم حزمة AndroidTV في "متجر Play" مثلاً: com.abc.media.atv.android
parentOrganization المؤسسة

مطلوبة: الموفّر الرئيسي للخدمة

parentOrganization.@type Text

مطلوبة - يتم ضبطها دائمًا على Organization.

parentOrganization.name Text

مطلوبة - اسم المؤسسة

subscriptions Mediaاشتراك

اختيارية - قائمة MediaSubscriptionsالمتوفّرة من خلال مقدّم الساعة

baseSubscriptionTier Mediaاشتراك

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

userRequestsFulfilledBy Text

اختياري - اضبط السمة على أي من الأطراف التالية التي تلبي طلبات المستخدمين:

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

تم ضبط هذا الموقع تلقائيًا على Google.

mediaOffered Text

مطلوبة: يتم ضبط السمة على أحد الخيارات التالية التي تتوافق مع أنواع المحتوى المضمّنة في الكتالوج المضمّنة في الخلاصة:

مثال على MediaService

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {
      "@context": [
        "http://schema.org",
        {
          "@language": "en"
        }
      ],
      "@type": "MediaService",
      "@id": "https://abcmedia.com",
      "name": [
        {
          "@language": "en-us",
          "@value": "ABC Media"
        },
        {
          "@language": "en-gb",
          "@value": "ABC"
        }
      ],
      "userRequestsFulfilledBy": "Google",
      "mediaOffered": [
        "LiveTV",
        "VoD"
      ],
      "brandIcon": [
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_16x16.png",
          "width": 16,
          "height": 16,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_20x20.png",
          "width": 20,
          "height": 20,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_40x40.png",
          "width": 40,
          "height": 40,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_44x44.png",
          "width": 44,
          "height": 44,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        },
        {
          "@type": "ImageObject",
          "contentURL": "https://abcmedia.com/path_to_logo_112x112.png",
          "width": 112,
          "height": 112,
          "additionalProperty": [
            {
              "@type": "PropertyValue",
              "name": "contentAttributes",
              "value": [
                "forDarkBackground",
                "forLightBackground"
              ]
            }
          ]
        }
      ],
      "application": [
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "Android",
          "downloadUrl": "https://google.play.store/com.abc.media.android",
          "identifier": "com.abc.media.android"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "iOS",
          "downloadUrl": "https://apple.app.store/967093455",
          "identifier": "967093455"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "AndroidTV",
          "downloadUrl": "https://google.play.store/com.abc.media.atv.android",
          "installUrl": "https://abcmedia.com/path_to_apkfile.apk",
          "identifier": "com.abc.media.atv.android"
        },
        {
          "@type": "SoftwareApplication",
          "operatingSystem": "Cast",
          "identifier": "ACDA4FDE"
        }
      ],
      "subscriptions": [
        {
          "@type": "MediaSubscription",
          "name": "Basic Package",
          "@id": "[partner determined string]",
          "identifier": "abcmedia.com:basic"
        },
        {
          "@type": "MediaSubscription",
          "name": "Premium Package",
          "@id": "[partner determined string]",
          "identifier": "abcmedia.com:premium"
        }
      ],
      "baseSubscriptionTier": {
        "@type": "MediaSubscription",
        "name": "Basic Package",
        "@id": "[partner determined string]",
        "identifier": "abcmedia.com:basic"
      },
      "parentOrganization": {
        "@type": "Organization",
        "name": "ABC Media"
      }
    }
  ]
}