Ví dụ về nguồn cấp dữ liệu cho Hành động nghe

Các ví dụ sau đây minh hoạ một số trường hợp phổ biến cho Hành động nghe. Để đơn giản hoá, các ví dụ này bỏ qua thông tin chi tiết về một số thuộc tính.

Trường hợp cơ sở

Một dịch vụ phát trực tuyến cung cấp nội dung độc quyền của nghệ sĩ (chỉ dành cho người đăng ký (subscribe)) và danh sách phát theo nghệ sĩ (dành cho tất cả mọi người (free)):

{
  "@context":["http://schema.googleapis.com/", {"@language": "en"}],
  "@type":"MusicGroup",
  "@id":"http://www.example.com/artist/my_favorite_artist/",
  "url":"http://www.example.com/artist/my_favorite_artist/",
  "sameAs": "http://www.my_favorite_artist.com",
  "name":"My Favorite Artist",
  "description":"This is my favorite 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"
      }
    }
  },
  "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 playlist of songs 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"
        }
      }
    }
  }
}

Chỉ danh sách phát

Dịch vụ phát trực tuyến chỉ cung cấp một danh sách phát:

{
  "@context":["http://schema.googleapis.com/", {"@language": "en"}],
  "@type":"MusicGroup",
  "@id":"http://www.example.com/artist/my_favorite_artist/",
  "url":"http://www.example.com/artist/my_favorite_artist/",
  "sameAs": "http://www.my_favorite_artist.com",
  "name":"My Favorite Artist",
  "description":"This is my favorite artist.",
  "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 playlist of songs 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"
        }
      }
    }
  }
}

Nhiều yêu cầu về khả năng hỗ trợ tiếp cận dựa trên nền tảng

Trường hợp cơ sở, nhưng giờ đây, nội dung của nghệ sĩ này đã có trên nền tảng máy tính cho mọi người:

{
  "@context":["http://schema.googleapis.com/", {"@language": "en"}],
  "@type":"MusicGroup",
  "@id":"http://www.example.com/artist/my_favorite_artist/",
  "url":"http://www.example.com/artist/my_favorite_artist/",
  "sameAs": "http://www.my_favorite_artist.com",
  "name":"My Favorite Artist",
  "description":"This is my favorite artist.",
  "potentialAction": [
    {
      "@type":"ListenAction",
      "target": {
        "@type":"EntryPoint",
        "urlTemplate":"http://www.example.com/artist/my_favorite_artist?autoplay=true",
        "actionPlatform":[
          "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"
        }
      }
    },
    {
      "@type":"ListenAction",
      "target": {
        "@type":"EntryPoint",
        "urlTemplate":"http://www.example.com/artist/my_favorite_artist?autoplay=true",
        "actionPlatform": "http://schema.org/DesktopWebPlatform"
      },
      "expectsAcceptanceOf":{
        "@type":"Offer",
        "category":"free",
        "eligibleRegion": {
          "@type":"Country",
          "name":"US"
        }
      }
    }
  ],
  "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 playlist of songs 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"
        }
      }
    }
  }
}

Nhiều yêu cầu về khả năng hỗ trợ tiếp cận theo khu vực

Đây là trường hợp cơ bản, nhưng hiện tại, nội dung của nghệ sĩ này đã được cung cấp cho mọi người trên tất cả nền tảng ở Canada:

{
  "@context":["http://schema.googleapis.com/", {"@language": "en"}],
  "@type":"MusicGroup",
  "@id":"http://www.example.com/artist/my_favorite_artist/",
  "url":"http://www.example.com/artist/my_favorite_artist/",
  "sameAs": "http://www.my_favorite_artist.com",
  "name":"My Favorite Artist",
  "description":"This is my favorite 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":"free",
        "eligibleRegion": {
          "@type":"Country",
          "name":"CA"
        }
      }
    },
    {
      "@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"
        }
      }
    }
  ],
  "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 playlist of songs 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"
          },
          {
            "@type":"Country",
            "name":"CA"
          }
        ]
      }
    }
  }
}

Nhiều khu vực và ngôn ngữ

Một thực thể có sẵn ở nhiều khu vực và ngôn ngữ:

Lưu ý: @language biểu thị ngôn ngữ dùng cho @value; không có nghĩa là nội dung có sẵn bằng ngôn ngữ đó hoặc ở khu vực đó. Ví dụ: pt-br trong @language không có nghĩa là nội dung có sẵn bằng tiếng Bồ Đào Nha ở Brazil; mã này xác định ngôn ngữ được sử dụng trong @value là tiếng Bồ Đào Nha Brazil. Sử dụng eligibleRegion để chỉ định vị trí cung cấp nội dung và sử dụng contentLanguage để chỉ định ngôn ngữ mà người dùng có thể sử dụng nội dung.

{
  "@context": ["http://schema.googleapis.com/", {"@language": "en"}],
  "@type": "MusicRecording",
  "@id": "https://example.com/us/recording/24335345",
  "url": "https://example.com/us/recording/24335345",
  "name": [
    {
      "@language": "fr-fr",
      "@value": "Amour"
    },
    {
      "@language": "en-us",
      "@value": "Love"
    }
  ],
  "byArtist": [
    {
      "@type": "MusicGroup",
      "@id": "https://example.com/us/artist/43265436",
      "name": [
        {
          "@language": "fr-fr",
          "@value": "Mon Artiste Préféré"
        },
        {
          "@language": "en-us",
          "@value": "My Favorite Artist"
        }
      ]
    }
  ],
  "inAlbum": [
    {
      "@type": "MusicAlbum",
      "@id": "https://example.com/us/album/24335345",
      "name": [
        {
          "@language": "fr-fr",
          "@value": "Mon Album Préféré"
        },
        {
          "@language": "en-us",
          "@value": "My Favorite Album"
        }
      ]
    }
  ],
  "potentialAction": [
    {
      "@type": "ListenAction",
      "target": [
        {
          "@type": "EntryPoint",
          "inLanguage": "en-us",
          "urlTemplate": "https://example.com/us/album/24335345",
          "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.googleapis.com/GoogleVideoCast",
            "http://schema.googleapis.com/GoogleAudioCast"
          ]
        },
        {
          "@type": "EntryPoint",
          "inLanguage": "en-us",
          "urlTemplate": "https://example.com/us/album/ios/24335345",
          "actionPlatform": [
            "http://schema.org/IOSPlatform"
          ]
        },
        {
          "@type": "EntryPoint",
          "inLanguage": "en-us",
          "urlTemplate": "android-app://com.example.android.music/https/example.com/us/24335345",
          "actionPlatform": [
            "http://schema.org/AndroidPlatform",
            "http://schema.org/AndroidTVPlatform"
          ]
        }
      ],
      "expectsAcceptanceOf": [
        {
          "@type": "Offer",
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "US"
            }
          ],
          "category": "subscription",
          "name": "Example Music",
          "price": 9.99,
          "priceCurrency": "USD",
          "seller": {
            "@type": "Organization",
            "name": "Example seller",
            "sameAs": "http://www.example.com"
          }
        }
      ]
    },
    {
      "@type": "ListenAction",
      "target": [
        {
          "@type": "EntryPoint",
          "inLanguage": "fr-fr",
          "urlTemplate": "https://example.com/fr/album/24335345",
          "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.googleapis.com/GoogleVideoCast",
            "http://schema.googleapis.com/GoogleAudioCast"
          ]
        },
        {
          "@type": "EntryPoint",
          "inLanguage": "fr-fr",
          "urlTemplate": "https://example.com/fr/album/ios/24335345",
          "actionPlatform": [
            "http://schema.org/IOSPlatform"
          ]
        },
        {
          "@type": "EntryPoint",
          "inLanguage": "fr-fr",
          "urlTemplate": "android-app://com.example.android.music/https/example.com/fr/24335345",
          "actionPlatform": [
            "http://schema.org/AndroidPlatform",
            "http://schema.org/AndroidTVPlatform"
          ]
        }
      ],
      "expectsAcceptanceOf": [
        {
          "@type": "Offer",
          "eligibleRegion": [
            {
              "@type": "Country",
              "name": "FR"
            }
          ],
          "category": "subscription",
          "name": "Example Music",
          "price": 5.99,
          "priceCurrency": "EUR",
          "seller": {
            "@type": "Organization",
            "name": "Example Seller",
            "sameAs": "http://www.example.com"
          }
        }
      ]
    }
  ]
}