หน้านี้ได้รับการแปลโดย Cloud Translation API

ภาพรวมโครงสร้างฟีด

ฟีดการดําเนินการกับสื่อคือออบเจ็กต์ JSON ที่มีคอลเล็กชันเอนทิตี เอนทิตีคือออบเจ็กต์ schema.org ที่แสดงถึงรายการในแคตตาล็อก เช่น ตอนของรายการทีวี ซีรีส์ทีวี ภาพยนตร์ เพลง อัลบั้ม และอื่นๆ

โครงสร้างฟีด

การดำเนินการเพื่อรับชมและการดำเนินการเพื่อฟังมีโครงสร้างฟีดที่แตกต่างกัน

การดำเนินการเพื่อรับชมมีลําดับชั้นดังนี้

ออบเจ็กต์ของโฟลเดอร์ฟีดข้อมูล

ออบเจ็กต์มาร์กอัปเนื้อหา

ออบเจ็กต์มาร์กอัปการดําเนินการ

ออบเจ็กต์เป้าหมาย
ออบเจ็กต์ข้อกำหนดการเข้าถึงการดําเนินการ

ออบเจ็กต์การสมัครใช้บริการสื่อ

ออบเจ็กต์ข้อเสนอ

การดำเนินการเพื่อฟังมีลําดับชั้นดังนี้

ออบเจ็กต์ของโฟลเดอร์ข้อมูล

ออบเจ็กต์มาร์กอัปเนื้อหา

ออบเจ็กต์มาร์กอัปการดําเนินการ

ออบเจ็กต์เป้าหมาย
ออบเจ็กต์ข้อเสนอ

ออบเจ็กต์มาร์กอัปเนื้อหา (การดำเนินการที่เริ่มต้นด้วยเอนทิตี)

ซองจดหมายฟีดข้อมูล

ซองจดหมายฟีดข้อมูลคือออบเจ็กต์ระดับบนสุดในฟีดการดําเนินการของสื่อ ออบเจ็กต์นี้มีอาร์เรย์ของออบเจ็กต์มาร์กอัปเนื้อหา (เอนทิตี) ที่แสดงเนื้อหาทั้งหมดในแคตตาล็อก

ซองจดหมายฟีดข้อมูลรองรับพร็อพเพอร์ตี้ต่อไปนี้

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
`@context`	URL	ต้องระบุ - ตั้งค่าเป็น `http://schema.org`
`@type`	Text	ต้องระบุ - ตั้งค่าเป็น `DataFeed`
`dateModified`	DateTime	ต้องระบุ - วันที่และเวลาที่แก้ไขฟีดครั้งล่าสุดในรูปแบบ ISO 8601 (รวมถึงเขตเวลา)
`dataFeedElement`	Thing	ต้องระบุ - เอนทิตีของแคตตาล็อกสื่อ

เทมเพลตไฟล์แนบฟีดข้อมูล

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    { <CONTENT MARKUP OBJECT 01> },
    { <CONTENT MARKUP OBJECT 02> },
    { <CONTENT MARKUP OBJECT 03> },
    ...
  ]
}

มาร์กอัปเนื้อหา

ออบเจ็กต์มาร์กอัปเนื้อหาแสดงถึงเอนทิตีเดียวในแคตตาล็อก เช่น ภาพยนตร์ ตอนของรายการทีวี ซีรีส์ทีวี เพลง อัลบั้ม สถานีวิทยุ ฯลฯ ออบเจ็กต์มีตัวระบุและ URL หลักของเนื้อหา และช่วยอธิบายเนื้อหาผ่านmetadata

เทมเพลตมาร์กอัปเนื้อหา

ออบเจ็กต์มาร์กอัปเนื้อหาอาจมีอาร์เรย์ของออบเจ็กต์มาร์กอัปการดําเนินการ ซึ่งช่วยให้เนื้อหาเชื่อมโยงกับออบเจ็กต์มาร์กอัปการดําเนินการหลายรายการได้ เช่น เนื้อหาอาจมีออบเจ็กต์มาร์กอัปการกระทําที่แตกต่างกันในแต่ละภูมิภาค

{
   "@context": ["http://schema.org", {"@language": "en"}],
   "@type": "Movie",
   "@id": "http://www.example.com/my_favorite_movie",
   "url": "http://www.example.com/my_favorite_movie",
   "name": "My Favorite Movie",
   "potentialAction": [
     { <ACTION MARKUP OBJECT 01> },
     { <ACTION MARKUP OBJECT 02> }
   ],
   ...
}

มาร์กอัปการดําเนินการ

ออบเจ็กต์มาร์กอัปการดําเนินการจะอธิบาย Deep Link ที่นําผู้ใช้ไปยังเนื้อหาและระดับการเข้าถึงที่จําเป็นสําหรับเนื้อหา ออบเจ็กต์นี้เป็นพร็อพเพอร์ตี้ (potentialAction) ของออบเจ็กต์มาร์กอัปเนื้อหา

การระบุข้อจํากัดการเข้าถึงทำได้ 2 วิธีดังนี้

สําหรับการดําเนินการบนนาฬิกา ให้ใช้ออบเจ็กต์ข้อกําหนดการเข้าถึงการดําเนินการ
สําหรับการดําเนินการเพื่อฟัง ให้ใช้ออบเจ็กต์ข้อเสนอ

เทมเพลตมาร์กอัปการดําเนินการ

หากเนื้อหามี Deep Link หลายรายการ ออบเจ็กต์มาร์กอัปการกระทําจะมีออบเจ็กต์เป้าหมายหลายรายการ เช่น ลิงก์ในรายละเอียดของเนื้อหาสำหรับ iOS อาจแตกต่างจากลิงก์ในรายละเอียดของ Android นอกจากนี้ หากมีการจํากัดการเข้าถึงที่แตกต่างกันตามภูมิภาคและระยะเวลา ออบเจ็กต์มาร์กอัปการดําเนินการอาจมีออบเจ็กต์ข้อกําหนดการเข้าถึงการดําเนินการหรือออบเจ็กต์ข้อเสนอหลายรายการ ดังที่แสดงในเทมเพลตด้านล่าง

เทมเพลตออบเจ็กต์มาร์กอัปการกระทําสําหรับการกระทําเพื่อรับชม

"potentialAction": {
  "@type": "WatchAction",
  "target": [
    { <TARGET OBJECT 01> },
    { <TARGET OBJECT 02> }
  ],
  "actionAccessibilityRequirement": [
    { <ACTION ACCESSIBILITY OBJECT 01> },
    { <ACTION ACCESSIBILITY OBJECT 02> }
  ]
}

เทมเพลตออบเจ็กต์มาร์กอัปการดําเนินการสําหรับการดําเนินการเพื่อฟัง

"potentialAction": {
  "@type": "ListenAction",
  "target": [
    { <TARGET OBJECT 01> },
    { <TARGET OBJECT 02> }
  ],
  "expectsAcceptanceOf": [
    { <OFFER OBJECT 01> },
    { <OFFER OBJECT 02> }
  ]
}

เป้าหมาย

ออบเจ็กต์เป้าหมายจะระบุการแมป Deep Link กับแพลตฟอร์มต่างๆ ของ Google ออบเจ็กต์นี้เป็นพร็อพเพอร์ตี้ (target) ของออบเจ็กต์มาร์กอัปการดําเนินการ

ตัวอย่างเป้าหมาย

หากเนื้อหามี Deep Link หลายรายการตามแพลตฟอร์ม ให้สร้างออบเจ็กต์เป้าหมายหลายรายการเพื่อให้มีการแมปที่แตกต่างกัน ตัวอย่างเช่น Deep Link ของเนื้อหาสำหรับ Chromecast อาจแตกต่างจาก Deep Link ของแพลตฟอร์มอื่นๆ ดังที่แสดงในตัวอย่างด้านล่าง

ตัวอย่างออบเจ็กต์เป้าหมาย (พื้นฐาน)

"target": {
  "@type": "EntryPoint",
  "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
  "actionPlatform": [
    "http://schema.org/DesktopWebPlatform",
    "http://schema.org/MobileWebPlatform",
    "http://schema.org/AndroidPlatform",
    "http://schema.org/AndroidTVPlatform",
    "http://schema.org/IOSPlatform",
    "http://schema.googleapis.com/GoogleVideoCast"
  ]
}

ตัวอย่างออบเจ็กต์เป้าหมายที่มี Deep Link 2 รายการ

"target": [
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
    "actionPlatform": [
      "http://schema.org/DesktopWebPlatform",
      "http://schema.org/MobileWebPlatform",
      "http://schema.org/AndroidPlatform",
      "http://schema.org/AndroidTVPlatform",
      "http://schema.org/IOSPlatform"
    ]
  },
  {
    "@type": "EntryPoint",
    "urlTemplate": "http://www.example.com/cast/my_favorite_movie?autoplay=true",
    "actionPlatform": [
      "http://schema.googleapis.com/GoogleVideoCast"
    ]
  }
]

ข้อกําหนดเฉพาะการเข้าถึงการดําเนินการ

ออบเจ็กต์ข้อกำหนดการเข้าถึงการดำเนินการจะอธิบายข้อกำหนดการเข้าถึงเนื้อหาตามภูมิภาคและระยะเวลา ออบเจ็กต์เป็นพร็อพเพอร์ตี้ actionAccessibilityRequirement ของออบเจ็กต์มาร์กอัปการดําเนินการ

category ของออบเจ็กต์อาจเป็นค่าใดก็ได้ต่อไปนี้

nologinrequired
free
subscription

หากต้องการอธิบายรายละเอียดของการสมัครใช้บริการ ให้สร้างออบเจ็กต์การสมัครใช้บริการสื่อ หากเนื้อหาต้องมีการซื้อเพิ่มเติมสำหรับผู้สมัครใช้บริการ ให้ใช้ออบเจ็กต์ข้อเสนอเพื่อระบุราคา
externalsubscription

หากต้องการอธิบายรายละเอียดของการสมัครใช้บริการ ให้สร้างออบเจ็กต์การสมัครใช้บริการสื่อ หากเนื้อหาต้องมีการซื้อเพิ่มเติมสำหรับผู้สมัครใช้บริการ ให้ใช้ออบเจ็กต์ข้อเสนอเพื่อระบุราคา
rental

ใช้ออบเจ็กต์ข้อเสนอเพื่อระบุราคา
purchase

ใช้ออบเจ็กต์ข้อเสนอเพื่อระบุราคา

การสมัครใช้บริการสื่อ

ออบเจ็กต์การสมัครใช้บริการสื่อจะอธิบายรายละเอียดของการสมัครใช้บริการที่จําเป็นสําหรับเนื้อหา ออบเจ็กต์นี้เป็นพร็อพเพอร์ตี้ requiresSubscription ของออบเจ็กต์ข้อกำหนดเฉพาะการเข้าถึงการดำเนินการ จำเป็นต้องระบุค่านี้หาก actionAccessibilityRequirement.category เป็น subscription หรือ externalSubscription และข้อเสนอการสมัครใช้บริการของคุณมีแพ็กเกจหรือระดับหลายรายการ หรือรองรับส่วนเสริม อย่าใส่ข้อมูลนี้หากการสมัครใช้บริการเป็นแบบชั้นเดียวและให้สิทธิ์เข้าถึงเนื้อหาทั้งหมดในแคตตาล็อก

ตัวอย่างการสมัครใช้บริการสื่อ

ตัวอย่างออบเจ็กต์การสมัครใช้บริการสื่อ

"requiresSubscription": {
  "@type": "MediaSubscription",
  "@id": "http://www.example.com/premium_subscription",
  "name": "Example Premium",
  "sameAs": "http://www.example.com/premium_subscription"
}

ข้อเสนอ

ออบเจ็กต์ข้อเสนอจะอธิบายราคาที่เชื่อมโยงกับเนื้อหา ออบเจ็กต์นี้เป็นพร็อพเพอร์ตี้ (expectsAcceptanceOf) ของออบเจ็กต์ต่อไปนี้

สําหรับการดําเนินการบนนาฬิกา ให้ใช้ออบเจ็กต์ข้อกําหนดการเข้าถึงการดําเนินการ
สําหรับการดําเนินการเพื่อฟัง ให้ใช้ออบเจ็กต์มาร์กอัปการดําเนินการ

ตัวอย่างข้อเสนอ

การดำเนินการเพื่อรับชมระบุพร็อพเพอร์ตี้ expectsAcceptanceOf ในออบเจ็กต์ข้อกำหนดการเข้าถึงการดําเนินการ

"potentialAction":{
  "@type":"WatchAction",
  "target":{
    "@type":"EntryPoint",
    "urlTemplate":"http://www.example.com/my_favorite_movie?autoplay=true",
    "actionPlatform":[ "http://schema.org/DesktopWebPlatform" ]
  },
  "actionAccessibilityRequirement": {
    "@type": "ActionAccessSpecification",
    "category": "purchase",
    "availabilityStarts": "2019-01-01T00:00Z",
    "availabilityEnds": "2019-12-31T00:00Z",
    "eligibleRegion": {
      "@type": "Country",
      "name": "US"
    },
    "expectsAcceptanceOf": {
      "@type": "Offer",
      "price": 7.99,
      "priceCurrency": "USD",
      "seller": {
        "@type": "Organization",
        "name": "My example seller"
      }
    }
  }
}

การดำเนินการแบบฟังเสียงจะระบุพร็อพเพอร์ตี้ expectsAcceptanceOf ในออบเจ็กต์มาร์กอัปการดําเนินการโดยตรง

"potentialAction":{
  "@type":"ListenAction",
  "target":{
    "@type":"EntryPoint",
    "urlTemplate":"http://www.example.com/playlist/top_pop_songs?autoplay=true",
    "actionPlatform":[ "http://schema.org/DesktopWebPlatform" ]
  },
  "expectsAcceptanceOf":{
    "@type": "Offer",
    "eligibleRegion": {
      "@type":"Country",
      "name":"US"
    },
    "category": "subscription",
    "name": "Example Music",
    "price": 9.99,
    "priceCurrency": "USD",
    "seller": {
      "@type": "Organization",
      "name": "My example seller",
      "sameAs": "http://www.example.com"
    }
  }
}

รูปภาพ

ออบเจ็กต์รูปภาพจะอธิบายรูปภาพที่เชื่อมโยงกับเนื้อหา

ข้อกำหนดสำหรับรูปภาพมีดังนี้

สำหรับการดำเนินการบนนาฬิกา ให้จัดเตรียมรูปภาพความละเอียดสูง (อย่างน้อย 140x210 พิกเซล) และสัดส่วนภาพ 2:3
- รูปภาพต้องอยู่ในรูปแบบ .jpg หรือ .png
สำหรับการดำเนินการฟัง ให้ใช้รูปภาพความละเอียดสูง (อย่างน้อย 300x300 พิกเซล) และสัดส่วนภาพ 1x1
- เราขอแนะนำให้ใช้ขนาด 600x600 พิกเซลขึ้นไป
- รูปภาพต้องอยู่ในรูปแบบ .jpg, .png หรือ .gif
URL ของรูปภาพต้องทำการ Crawl และจัดทำดัชนีได้
คุณต้องมีสิทธิ์ใช้รูปภาพและอนุญาตให้แสดงรูปภาพในอุปกรณ์และพร็อพเพอร์ตี้ของ Google
รูปภาพต้องไม่มีสิ่งต่อไปนี้
- รูปภาพเบลอ แตกเป็นพิกเซล หมุน หรือมีคุณภาพต่ำ
- รูปภาพที่ไม่มีใบอนุญาตหรือรูปภาพสต็อก
- ภาพเปลือย
- เนื้อหาที่ผิดกฎหมาย
เมื่ออัปเดต MusicPlaylist ให้อัปเดตรูปภาพให้สอดคล้องกับเนื้อหาใหม่

ตัวอย่างรูปภาพ

"image": {
  "@type": "ImageObject",
  "contentUrl" : "http://www.example.com/artist/my_favorite_artist/1x1/photo1.jpg",
  "dateModified" : "2019-01-05T22:11:33+00:00",
  "regionsAllowed" : ["US","UK","MX"]
}

ตัวอย่างฟีด

ตัวอย่างต่อไปนี้แสดงความแตกต่างของโครงสร้างฟีดระหว่างการกระทําในการดูกับการกระทําในการฟัง

ตัวอย่างการดำเนินการเพื่อรับชม

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {
      "@context": ["http://schema.org", {"@language": "en"}],
      "@type": "Movie",
      "@id": "http://www.example.com/my_favorite_movie",
      "url": "http://www.example.com/my_favorite_movie",
      "name": "My Favorite Movie",
      "potentialAction": {
        "@type": "WatchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
          "inLanguage": "en",
          "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/MobileWebPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/AndroidTVPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
         "actionAccessibilityRequirement": {
           "@type": "ActionAccessSpecification",
           "category": "subscription",
           "availabilityStarts": "2018-07-21T10:35:29Z",
           "availabilityEnds": "2019-10-21T10:35:29Z",
           "eligibleRegion": [
             {
                "@type": "Country",
                "name": "US"
             },
             {
                "@type": "Country",
                "name": "CA"
             }
           ],
        }
      },
      "sameAs": "https://en.wikipedia.org/wiki/my_favorite_movie",
      "releasedEvent": {
        "@type": "PublicationEvent",
        "startDate": "2008-01-20",
        "location": {
          "@type": "Country",
          "name": "US"
        }
      },
      "description": "This is my favorite movie.",
      "actor": [
        {
          "@type": "Person",
          "name": "John Doe",
          "sameAs": "https://en.wikipedia.org/wiki/John_Doe"
        },
        {
          "@type": "Person",
          "name": "Jane Doe",
          "sameAs": "https://en.wikipedia.org/wiki/Jane_Doe"
        }
      ],
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "IMDB_ID",
          "value":  "tt0123456"
        }
      ]
    }
  ]
}

ตัวอย่างการดำเนินการเพื่อฟัง

{
  "@context": "http://schema.org",
  "@type": "DataFeed",
  "dateModified": "2018-07-20T00:44:51Z",
  "dataFeedElement": [
    {
      "@context":"http://schema.googleapis.com/",
      "@type":"MusicGroup",
      "@id":"http://www.example.com/artist/my_favorite_artist/",
      "url":"http://www.example.com/artist/my_favorite_artist/",
      "name":"My Favorite Artist",
      "sameAs":"https://en.wikipedia.org/wiki/my_favorite_artist",
      "description":"This is my favorite pop music artist.",
      "potentialAction": {
        "@type":"ListenAction",
        "target": {
          "@type":"EntryPoint",
          "urlTemplate":"http://www.example.com/artist/my_favorite_artist?autoplay=true",
          "actionPlatform":[
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/AndroidTVPlatform",
            "http://schema.googleapis.com/GoogleAudioCast",
            "http://schema.googleapis.com/GoogleVideoCast"
          ]
        },
        "expectsAcceptanceOf":{
          "@type":"Offer",
          "category":"subscription",
          "eligibleRegion": {
            "@type":"Country",
            "name":"US"
          },
          "price": 8.99,
          "priceCurrency": "USD"
        }
      },
      "subjectOf": {
        "@type":"MusicPlaylist",
        "@id":"http://www.example.com/artist_mix/my_favorite_artist/",
        "url":"http://www.example.com/artist_mix/my_favorite_artist/",
        "name":"My Favorite Artist Mix",
        "description":"A mix of music similar to My Favorite Artist",
        "potentialAction":{
          "@type":"ListenAction",
          "target": {
            "@type":"EntryPoint",
            "urlTemplate":"http://www.example.com/artist_mix/my_favorite_artist?autoplay=true",
            "actionPlatform":[
              "http://schema.org/DesktopWebPlatform",
              "http://schema.org/IOSPlatform",
              "http://schema.org/AndroidPlatform",
              "http://schema.org/AndroidTVPlatform",
              "http://schema.googleapis.com/GoogleAudioCast",
              "http://schema.googleapis.com/GoogleVideoCast"
            ]
          },
          "expectsAcceptanceOf":{
            "@type":"Offer",
            "category":"free",
            "eligibleRegion": {
              "@type":"Country",
              "name":"US"
            }
          }
        }
      }
    }
  ]
}