Exemples de flux d'actions d'écoute

Les exemples suivants illustrent certains scénarios courants d'actions d'écoute. Pour simplifier, ces exemples omettent les détails de certaines propriétés.

Étui de base

Un service de streaming fournit les contenus exclusifs d'un artiste, qui sont réservés aux abonnés (subscribe), et une playlist basée sur l'artiste, accessible à tous (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"
        }
      }
    }
  }
}

Playlist uniquement

Un service de streaming ne fournit qu'une playlist:

{
  "@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"
        }
      }
    }
  }
}

Plusieurs exigences d'accessibilité basées sur la plate-forme

Le cas de base, mais le contenu de l'artiste est désormais disponible pour tous sur ordinateur. plate-forme:

{
  "@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"
        }
      }
    }
  }
}

Exigences d'accessibilité régionales multiples

Le cas de base, mais le contenu de l'artiste est désormais disponible pour tous sur toutes les plates-formes au 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"
          }
        ]
      }
    }
  }
}

Plusieurs régions et langues

Une entité est disponible dans plusieurs régions et langues:

Remarque :@language indique la langue utilisée pour @value. ne signifie pas que le contenu est disponible dans cette langue ou dans cette région. Par exemple, la mention pt-br dans l'attribut @language ne signifie pas que le contenu est disponible en portugais au Brésil. la langue utilisée dans @value est en portugais brésilien. Utilisez eligibleRegion pour indiquer où le contenu est disponible et contentLanguage pour indiquer la langue dans laquelle les utilisateurs peuvent consulter le contenu.

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