خصائص ترميز المحتوى في 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 كيلوبايت
  • ‫40×40 بكسل، بملف لا يزيد حجمه عن 1 كيلوبايت
  • ‫44×44 بكسل، بملف لا يزيد حجمه عن 1 كيلوبايت
  • ‫112×112 بكسل، بملف لا يزيد حجمه عن 3 كيلوبايت

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

  • رمز مربّع واحد بتنسيق ملف PNG (درجة دقتها 512 × 512 بكسل ونسبة العرض إلى الارتفاع 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 SotfwareApplication

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

  • iOS
  • Android
  • بثّ
  • AndroidTV
application.@type Text

مطلوبة: يتم ضبطها دائمًا على SoftwareApplication.
application.operatingSystem Text

مطلوب: اضبط القيمة على أحد الخيارَين التاليَين:

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

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

وبالنسبة إلى جميع المنصّات الأخرى، هذه السمة غير مطلوبة.
application.installUrl URL

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

إذا لم يقدّم الموفّر إمكانية تشغيل المحتوى على AndroidTV، لن تكون هذه السمة مطلوبة.
application.identifier

Text

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

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

مطلوبة: مقدّم الخدمة الرئيسي.
parentOrganization.@type Text

مطلوبة: يتم ضبطها دائمًا على Organization.
parentOrganization.name Text

مطلوبة: اسم المؤسسة.
subscriptions MediaSubscription

اختياري: قائمة MediaSubscriptions المتوفّرة والمتوافقة مع مقدّم خدمة الساعة
baseSubscriptionTier MediaSubscription

مطلوبة إذا كان ذلك منطبقًا: إذا كان موفّر المحتوى وموفّر الخدمة يملكان حزمة اشتراك أساسي ، يجب ضبط هذا العنصر على مثيل الاشتراك للمحتوى المتاح لجميع المشتركين. ولا يُطلب استخدام هذه السمة بخلاف ذلك.
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"
      }
    }
  ]
}