خصائص ترميز المحتوى في 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 كيلوبايت
  • 20x20 بكسل، مع ملف لا يزيد حجمه عن 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، عليك تحديد هذا الخيار كرابط إلى ملف 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 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"
      }
    }
  ]
}