این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

ویژگی های نشانه گذاری محتوا MediaService (الزامی)

این بخش جزئیات ویژگی های نشانه گذاری محتوا را برای نوع نهاد MediaService ارائه می دهد که پیکربندی ادغام Media Action شما را نشان می دهد.

نکته کلیدی: نهاد MediaService باید در آرایه dataFeedElement محصور شود. مثال زیر را ببینید

نکته کلیدی: هر ارسالی فید Media Actions باید شامل یک و تنها یک نهاد MediaService برای هر ارائه‌دهنده پیوند عمیق تحت پوشش فید باشد.

جدول مشخصات

ویژگی	نوع مورد انتظار	شرح
`@type`	متن	مورد نیاز - همیشه روی `MediaService` تنظیم شود.
`@context`	متن	مورد نیاز - همیشه روی `["http://schema.org", {"@language": "xx"}]` تنظیم شود.
`@id`	URL	مورد نیاز - یک شناسه منحصر به فرد برای نام تجاری شما. برای مثال، `https://example.com` . شناسه باید الزامات زیر را رعایت کند: در سراسر کاتالوگ شما در سطح جهانی منحصر به فرد است. ایستا است. شناسه باید ثابت باشد و در طول زمان تغییر نکند. این در قالب Unified Resource Identifier (URI) است. دامنه آن باید متعلق به سازمان شما باشد.
`name`	متن	مورد نیاز - نام ارائه دهنده. اگر نام تجاری شما دارای نام های محلی خاص است، آنها را در یک آرایه فهرست کنید. برای مثال، به مثال MediaService مراجعه کنید.
`brandIcon`	ImageObject	برای همه Watch Actions و Listen Actions لازم است - فایل تصویر نماد برند شما، برای هر اندازه تکرار می شود. در نتیجه اقدام تماشا/گوش دادن، Google پیوندهای عمیق محتوای شما را به نماد برند شما مرتبط می‌کند. فایل تصویر نماد برند شما باید شرایط زیر را رعایت کند: این یک فایل PNG است. پس زمینه آن شفاف است. شکل آن گرد است. مطمئن شوید که تصاویر ضد مستعار هستند و تحریف/پیکسل نشده اند این ویژگی باید تکرار شود، زیرا شما باید پنج تصویر ارائه دهید، یکی برای هر یک از ابعاد زیر: 16x16 پیکسل، با فایلی که بیشتر از 1 کیلوبایت نباشد 20x20 پیکسل، با فایلی که بیشتر از 1 کیلوبایت نباشد 40x40 پیکسل، با فایلی که بیشتر از 1 کیلوبایت نباشد 44x44 پیکسل، با فایلی که بیشتر از 1 کیلوبایت نباشد 112x112 پیکسل، با فایلی که بیشتر از 3 کیلوبایت نباشد نیاز اضافی برای ادغام GoogleTV - این تصاویر نماد برند شما در بالای راهنمای برنامه‌نویسی، روی دکمه‌های Watch Action و در تنظیمات Google TV نمایش داده می‌شوند. سه نماد با شرایط زیر ارائه دهید: یک نماد مربع در فرمت فایل PNG. (با وضوح 512x512 پیکسل، نسبت تصویر 1:1) یک نماد علامت کلمه سفید در فرمت فایل PNG. (بالاترین وضوح موجود، هیچ اولویتی برای نسبت تصویر وجود ندارد) یک نماد علامت کلمه رنگی در فرمت فایل PNG. (بالاترین وضوح موجود، هیچ اولویتی برای نسبت تصویر وجود ندارد) مطمئن شوید که تصاویر ضد مستعار هستند و تحریف/پیکسل نشده اند.
`brandIcon.contentURL`	URL	مورد نیاز - URL تصویر.
`brandIcon.height`	عدد	مورد نیاز - ارتفاع تصویر، بر حسب پیکسل.
`brandIcon.width`	عدد	مورد نیاز - عرض تصویر، بر حسب پیکسل.
`brandIcon.additionalProperty`	PropertyValue	مورد نیاز - ویژگی اضافی مورد استفاده برای توصیف نوع تصویر و تعریف کاربردهای مورد نظر آن.
`brandIcon.additionalProperty.@type`	متن	مورد نیاز - روی `PropertyValue` تنظیم کنید.
`brandIcon.additionalProperty.name`	متن	مورد نیاز - روی `contentAttributes` تنظیم کنید.
`brandIcon.additionalProperty.value`	متن	مورد نیاز - مناسب بودن پس زمینه. برای معتبر بودن، حداقل یکی از مقادیر زیر را تنظیم کنید: `forDarkBackground` : تصویری که معمولاً یک نماد شفاف است که برای استفاده در پس زمینه تاریک مناسب است. `forLightBackground` : تصویری که معمولاً یک نماد شفاف است و برای استفاده در پس‌زمینه روشن مناسب است.
`application`	نرم افزار Sotfware	در صورت ارائه برنامه‌های iOS، Android، Cast یا AndroidTV الزامی است - فهرست برنامه‌های نام تجاری شما در موارد زیر: iOS اندروید قالب AndroidTV
`application.@type`	متن	مورد نیاز - همیشه روی `SoftwareApplication` تنظیم شود.
`application.operatingSystem`	متن	مورد نیاز - روی یکی از موارد زیر تنظیم کنید: `iOS` `Android` `Cast` `AndroidTV`
`application.downloadUrl`	URL	در صورت وجود الزامی است - برای پلتفرم های Android، AndroidTV و iOS، باید این را به عنوان پیوند برنامه خود در فروشگاه App و Play Store مشخص کنید. برای همه پلتفرم‌های دیگر، این ویژگی الزامی نیست.
`application.installUrl`	URL	در صورت وجود الزامی است - اگر ارائه دهنده پخش رسانه را از طریق برنامه AndroidTV ارائه می دهد، باید آن را به عنوان پیوند به فایل APK AndroidTV مشخص کنید. اگر ارائه دهنده پخش AndroidTV را ارائه نمی دهد، این ویژگی الزامی نیست.
`application.identifier`	متن	در صورت وجود الزامی است - برای پلتفرم هایی که با یکی از مقادیر زیر مطابقت دارند، آن را مطابق با آن تنظیم کنید. این ویژگی در غیر این صورت مورد نیاز نیست: iOS: شناسه برنامه App Store. برای مثال `967093455` . Android: نام بسته اندروید فروشگاه Play. به عنوان مثال، `com.abc.media.android` . Cast: شناسه برنامه Cast. به عنوان مثال، `ACDA4FDE` . AndroidTV: نام بسته AndroidTV فروشگاه Play. برای مثال، `com.abc.media.atv.android` .
`parentOrganization`	سازمان	مورد نیاز - ارائه دهنده والد سرویس.
`parentOrganization.@type`	متن	مورد نیاز - همیشه روی `Organization` تنظیم شود.
`parentOrganization.name`	متن	مورد نیاز - نام سازمان.
`subscriptions`	اشتراک رسانه	اختیاری - لیستی از `MediaSubscriptions` موجود که توسط ارائه‌دهنده ساعت پشتیبانی می‌شوند.
`baseSubscriptionTier`	اشتراک رسانه	در صورت وجود الزامی است - اگر ارائه‌دهنده ساعت و ارائه‌دهنده بسته اشتراک پایه دارند، باید آن را روی نمونه اشتراک برای محتوایی که برای همه مشترکین در دسترس است تنظیم کنید. این ویژگی در غیر این صورت مورد نیاز نیست.
`userRequestsFulfilledBy`	متن	اختیاری - روی یکی از طرف‌های زیر که درخواست‌های کاربر را برآورده می‌کنند، تنظیم کنید: `Google` : همه درخواست‌ها توسط Google انجام می‌شود. در اصل، گوگل پیوند عمیق را برای محتوای درخواستی برمی گرداند. `Provider` : همه درخواست‌ها توسط ارائه‌دهنده محتوا – ارائه‌دهنده ابر، برآورده می‌شوند. اساسا، ارائه دهنده پیوند عمیق را برای محتوای درخواستی برمی گرداند یا پخش را مستقیماً در دستگاه های خود آغاز می کند. به طور پیش فرض این ویژگی روی `Google` تنظیم شده است.
`mediaOffered`	متن	مورد نیاز - یکی از موارد زیر را تنظیم کنید، که مطابق با انواع محتوای موجود در کاتالوگ شما در فید است: `["VoD"]` - ارائه دهنده فقط محتوای ویدیوی درخواستی (VoD) را در فید شامل می شود. محتوای VoD شامل فیلم‌ها و نمایش‌های تلویزیونی است. `["LiveTV"]` - ارائه‌دهنده فقط Live TV را که شامل کانال‌ها و محتوای BroadcastEvent می‌شود، در فید شامل می‌شود. `["VoD", "LiveTV"]` - ارائه دهنده هر دو محتوای VoD و Live TV را در فید شامل می شود. `["Music"]` - ارائه دهنده فقط موجودیت های موسیقی را در فید شامل می شود. این شامل آلبوم، هنرمندان، آهنگ‌ها و محتوای فهرست پخش می‌شود. `["Radio"]` - ارائه دهنده فقط موجودیت های رادیویی را در فید شامل می شود. `["Music", "Radio"]` - ارائه دهنده موسیقی و موجودیت های رادیویی را در فید شامل می شود. این شامل آلبوم، هنرمندان، آهنگ‌ها ، فهرست پخش و محتوای ایستگاه رادیویی است. توجه: ابزارهای اعتبارسنجی از این برای اعمال اعتبارسنجی مناسب استفاده می کنند.

مثال 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"
      }
    }
  ]
}