พร็อพเพอร์ตี้มาร์กอัปเนื้อหาของ MediaService (ต้องระบุ)

ส่วนนี้แสดงรายละเอียดของพร็อพเพอร์ตี้มาร์กอัปเนื้อหาสำหรับ เอนทิตี MediaService ประเภทที่บันทึกการกำหนดค่าสำหรับการดำเนินการกับสื่อของคุณ การผสานรวม

ตารางข้อกำหนด

พร็อพเพอร์ตี้ ประเภทที่คาดหวัง คำอธิบาย
@type Text

ต้องระบุ - ตั้งค่าเป็น MediaService เสมอ
@context Text

ต้องระบุ - ตั้งค่าเป็น ["http://schema.org", {"@language": "xx"}] เสมอ
@id URL

ต้องระบุ - ตัวระบุที่ไม่ซ้ำกันสำหรับแบรนด์ ตัวอย่างเช่น https://example.com

ตัวระบุต้องเป็นไปตามข้อกำหนดต่อไปนี้

  • ซึ่งจะไม่ซ้ำกันในแคตตาล็อกของคุณทั่วโลก
  • เป็นภาพนิ่ง รหัสต้องคงที่และไม่มีการเปลี่ยนแปลงเมื่อเวลาผ่านไป
  • ไฟล์อยู่ในรูปแบบ Unified Resource Identifier (URI)
  • โดเมนต้องเป็นขององค์กรคุณ
name Text

ต้องระบุ - ชื่อผู้ให้บริการ

หากแบรนด์มีชื่อเฉพาะภาษา ให้ระบุในอาร์เรย์ ในตัวอย่างนี้ ดูตัวอย่าง MediaService
brandIcon ImageObject

ต้องระบุสำหรับการดำเนินการในนาฬิกาและการฟังทั้งหมด - ไฟล์ภาพของแบรนด์ ไอคอนซ้ำกัน สำหรับแต่ละขนาด ในผลการค้นหาการดำเนินการ "ดู/ฟัง" Google จะเชื่อมโยง Deep Link ของเนื้อหาไปยังไอคอนแบรนด์ของคุณ

ไฟล์ภาพไอคอนแบรนด์ต้องเป็นไปตามข้อกำหนดต่อไปนี้

  • ซึ่งเป็นไฟล์ PNG
  • พื้นหลังเป็นแบบโปร่งใส
  • รูปทรงกลมตามธรรมชาติ
  • ตรวจสอบว่ารูปภาพมีรอยหยักและไม่มีการบิดเบี้ยว/แตกเป็นพิกเซล

พร็อพเพอร์ตี้นี้ต้องซ้ำกัน เนื่องจากคุณต้องระบุรูปภาพ 5 รูป แต่ละรูป มิติข้อมูลต่อไปนี้

  • 16x16 พิกเซล โดยมีไฟล์ขนาดไม่เกิน 1 KB
  • 20x20 พิกเซล โดยมีไฟล์ขนาดไม่เกิน 1 KB
  • 40x40 พิกเซล โดยมีไฟล์ขนาดไม่เกิน 1 KB
  • 44x44 พิกเซล โดยมีไฟล์ขนาดไม่เกิน 1 KB
  • 112x112 พิกเซล โดยมีไฟล์ขนาดไม่เกิน 3 KB

ข้อกำหนดเพิ่มเติมสำหรับการผสานรวม Google TV - รูปภาพแบรนด์ของคุณเหล่านี้ จะปรากฏที่ด้านบนของคู่มือการจัดโปรแกรมบนปุ่มการดำเนินการในการรับชม และ ในการตั้งค่า Google TV ระบุไอคอน 3 รายการที่เป็นไปตามข้อกำหนดต่อไปนี้

  • ไอคอนสี่เหลี่ยมจัตุรัส 1 รายการในรูปแบบไฟล์ PNG (ความละเอียด 512x512 พิกเซล สัดส่วนภาพ 1:1)
  • ไอคอนโลโก้ตัวอักษรล้วนสีขาว 1 ไอคอนในรูปแบบไฟล์ PNG (มีความละเอียดสูงสุด ไม่มีค่ากำหนดสำหรับสัดส่วนภาพ)
  • ไอคอนโลโก้ตัวอักษรล้วนที่มีสี 1 รายการในรูปแบบไฟล์ 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

ต้องระบุ - ความเหมาะสมกับพื้นหลัง

ตั้งค่าที่ถูกต้องให้เป็นค่าต่อไปนี้อย่างน้อย 1 ค่า

  • 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 Store

ไม่จำเป็นต้องเป็นพร็อพเพอร์ตี้สำหรับแพลตฟอร์มอื่นๆ ทั้งหมด
application.installUrl URL

ต้องระบุ (หากมี) - ในกรณีที่ผู้ให้บริการเสนอการเล่นสื่อผ่าน แอป AndroidTV คุณต้องระบุข้อมูลนี้เป็นลิงก์ไปยังไฟล์ APK ของ AndroidTV

หากผู้ให้บริการไม่ให้บริการเล่นบน AndroidTV ก็ไม่จำเป็นต้องมีพร็อพเพอร์ตี้นี้
application.identifier

Text

ต้องระบุ (หากมี) - สำหรับแพลตฟอร์มที่สอดคล้องกับข้อใดข้อหนึ่งต่อไปนี้ ให้กำหนดตามลำดับ หรือไม่ต้องระบุพร็อพเพอร์ตี้นี้

  • iOS: ตัวระบุแอป App Store เช่น 967093455
  • Android: ชื่อแพ็กเกจ Android ใน Play Store ตัวอย่างเช่น com.abc.media.android
  • แคสต์: รหัสแอปแคสต์ เช่น ACDA4FDE
  • AndroidTV: ชื่อแพ็กเกจ AndroidTV ใน Play Store ตัวอย่างเช่น com.abc.media.atv.android
parentOrganization องค์กร

ต้องระบุ - ผู้ให้บริการระดับบนสุดของบริการ
parentOrganization.@type Text

ต้องระบุ - ตั้งค่าเป็น Organization เสมอ
parentOrganization.name Text

ต้องระบุ - ชื่อองค์กร
subscriptions MediaSubscription

ไม่บังคับ - รายการ MediaSubscriptions ที่ใช้ได้ ที่ผู้ให้บริการนาฬิการองรับ
baseSubscriptionTier MediaSubscription

ต้องระบุ (หากมี) - หากผู้ให้บริการนาฬิกาและผู้ให้บริการมีฐาน แพ็กเกจการสมัครสมาชิก คุณต้องตั้งค่าสิ่งนี้เป็นอินสแตนซ์การสมัครสมาชิกสำหรับเนื้อหาที่พร้อมใช้งาน สำหรับสมาชิกทุกคน หรือไม่ต้องระบุพร็อพเพอร์ตี้นี้
userRequestsFulfilledBy Text

ไม่บังคับ - ตั้งค่าเป็นฝ่ายใดก็ได้ต่อไปนี้ที่ดำเนินการตามผู้ใช้ คำขอ:

  • Google: Google จะเป็นผู้ดำเนินการตามคำขอทั้งหมด โดยพื้นฐานแล้ว Google แสดง Deep Link ของเนื้อหาที่ขอ
  • Provider: คำขอทั้งหมดจะดำเนินการโดยผู้ให้บริการเนื้อหา ซึ่งได้แก่ ผู้ให้บริการคลาวด์ ผู้ให้บริการจะแสดง Deep Link ของเนื้อหาที่ร้องขอ หรือเริ่มเล่นในอุปกรณ์ของผู้ใช้โดยตรง

พร็อพเพอร์ตี้นี้จะตั้งค่าเป็น 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"
      }
    }
  ]
}