พร็อพเพอร์ตี้มาร์กอัปเนื้อหาของ 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 จะเชื่อมโยงลิงก์ในรายละเอียดของเนื้อหากับไอคอนแบรนด์ของคุณบนผลลัพธ์ของการดู/การฟัง

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

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

พร็อพเพอร์ตี้นี้ต้องเป็นข้อมูลซ้ําเพราะคุณต้องใส่รูปภาพ 5 ภาพ 1 รายการในแต่ละขนาดต่อไปนี้

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

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

  • ไอคอนสี่เหลี่ยมในรูปแบบไฟล์ PNG (ที่มีความละเอียด 512x512 พิกเซล สัดส่วนภาพ 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

จําเป็น - ความเหมาะสมกับพื้นหลัง

ตั้งค่าให้ถูกต้องอย่างน้อย 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
  • Cast: รหัสแอป Cast เช่น ACDA4FDE
  • AndroidTV: ชื่อแพ็กเกจ AndroidTV ของ Play Store เช่น com.abc.media.atv.android
parentOrganization องค์กร

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

parentOrganization.@type Text

จําเป็น - ตั้งค่าเป็น Organization เสมอ

parentOrganization.name Text

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

subscriptions MediaMedia

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

baseSubscriptionTier MediaMedia

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

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"
      }
    }
  ]
}