พร็อพเพอร์ตี้มาร์กอัปเนื้อหาของ 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 รูป โดยให้รูปภาพ 1 รูปสำหรับแต่ละมิติข้อมูลต่อไปนี้

  • 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

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

ตั้งค่าเป็นค่าใดค่าหนึ่งต่อไปนี้เป็นอย่างน้อยเพื่อให้ถูกต้อง

  • 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 คุณต้องระบุ URL นี้เป็นลิงก์ไปยังแอปพลิเคชันใน 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
  • Cast: รหัสแอป Cast เช่น 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"
      }
    }
  ]
}