SportsEvents : modélisation, bonnes pratiques et exemple de flux

Définition

Un SportsEvent est un type d'entité représentant un match de sport ou une rediffusion complète d'un match de sport.

Qu'est-ce qui peut être modélisé en tant que SportsEvent ? Un match de sport
Qu'est-ce qui ne peut pas être modélisé en tant que SportsEvent ?

Tout contenu court, extrait ou contenu supplémentaire. Voici la liste :

  • Récapitulatif aléatoire ou rediffusion de courts extraits
  • Aperçus du jeu
  • Temps forts du match
  • Bêtisier du jeu
  • Extraits d'interviews de joueurs
  • Vidéos des coulisses
  • Avis sur les jeux (générés par les utilisateurs ou non)
  • Extraits vidéo courts aléatoires du jeu

Comment gérer ces contenus supplémentaires ?

Cas d'utilisation courants pour SportsEvents

S.No. Description Entités requises
Cas 1

Je dois modéliser un SportsEvent qui fait partie de mon catalogue de télévision en direct et qui est diffusé en ligne.

Le match est diffusé en streaming sur Internet et n'est associé à aucune chaîne.

SportsEvent représentant le jeu.

BroadcastEvent représentant la diffusion du match.

Cas 2 Je souhaite modéliser un SportsEvent qui fait partie de mon catalogue de télévision en direct et qui est diffusé en ligne sur une chaîne.

SportsEvent représentant le jeu.

BroadcastEvent représentant la diffusion du match.

BroadcastService, Organization, TelevisionChannel, CableOrSatelliteService : entités représentant la chaîne et la programmation.

Cas 3 Combinaisons des deux cas précédents. Si vous combinez les cas d'utilisation précédents, indiquez tous les types d'entités listés dans la colonne "Entités requises" correspondante.

Bonnes pratiques et informations sur quelques-unes des vérifications que nous effectuons

Les consignes et contrôles qualité suivants s'appliquent lors de la modélisation d'événements sportifs et de leurs diffusions.

Appliquez les règles suivantes à toutes les intégrations SportsEvent :

  • Placer tous les liens profonds de sport sur SportsEvent.potentialAction : les liens profonds au niveau du match (WatchAction), pour les diffusions en direct sans chaîne et les rediffusions de vidéos à la demande, doivent se trouver exclusivement sur l'entité SportsEvent (SportsEvent.potentialAction). Ne placez jamais potentialAction sur un BroadcastEvent qui fait référence à un SportsEvent. (Pour les diffusions de chaînes linéaires sans lien profond spécifique à l'événement, indiquez le lien profond de la chaîne sur BroadcastService.potentialAction.) Si un match est diffusé sur plusieurs flux (par exemple, des flux régionaux, des diffusions à domicile ou à l'extérieur, plusieurs langues ou des URL de rediffusion en direct et de vidéo à la demande distinctes), fournissez un tableau d'objets WatchAction dans SportsEvent.potentialAction.
  • Fenêtre pré-roll (availabilityStarts) : définissez SportsEvent.potentialAction.actionAccessibilityRequirement.availabilityStarts au moins 14 jours avant SportsEvent.startDate (availabilityStarts <= SportsEvent.startDate - 14 days) pour que les tuiles des matchs à venir et les notifications de rappel puissent s'afficher à l'avance. Vous n'avez pas besoin de fournir l'entité de flux 14 jours à l'avance. Les données d'événement peuvent être fournies plus près du jour du match, à condition que le code temporel availabilityStarts soit défini au moins 14 jours avant SportsEvent.startDate.
  • Marge de sécurité pour les prolongations (availabilityEnds) : définissez SportsEvent.potentialAction.actionAccessibilityRequirement.availabilityEnds après SportsEvent.endDate avec une marge de sécurité d'au moins deux à trois heures (availabilityEnds >= SportsEvent.endDate + 2 to 3 hours ou jusqu'à la fin de la période de rediffusion de la vidéo à la demande) afin que le lien profond n'expire pas pendant les prolongations en direct ou la couverture d'après-match.
  • Exigences pour @id et url :
    • Utilisez des valeurs @id distinctes : BroadcastEvent.@id doit être différent de SportsEvent.@id.
    • Omettre url : n'incluez pas de propriété url sur les entités BroadcastEvent ou SportsEvent.
S.No. Entités requises Consignes
Cas 1

Je dois modéliser un SportsEvent qui fait partie de mon catalogue de télévision en direct et qui est diffusé en ligne.

Le match est diffusé en streaming sur Internet et n'est associé à aucune chaîne.

Entités requises

  • SportsEvent représentant le jeu
  • BroadcastEvent représentant la diffusion du match

Consignes de modélisation

Sous-cas 1 : Le match n'est disponible qu'en direct (et ne fait pas partie du catalogue de vidéos à la demande)

  • Fournissez l'entité BroadcastEvent pour partager le calendrier de diffusion, en référençant le match avec BroadcastEvent.broadcastOfEvent et en spécifiant le pays de diffusion dans BroadcastEvent.location.
  • Indiquez le lien profond de la diffusion en direct sur l'entité SportsEvent à l'aide de SportsEvent.potentialAction (configuré avec le pré-roll de 14 jours availabilityStarts et le tampon de prolongation de 2 à 3 heures availabilityEnds).
  • Ne fournissez pas BroadcastEvent.potentialAction, BroadcastEvent.url ou SportsEvent.url.
  • Ne fournissez pas de BroadcastEvent.publishedOn, car le match est diffusé en streaming en ligne sans chaîne linéaire.

Sous-cas 2 : Le match est disponible en direct et dans le catalogue de vidéos à la demande (par exemple, lorsque les rediffusions complètes du match restent disponibles à la demande)

  • Fournissez l'entité BroadcastEvent pour partager la programmation de chaque diffusion (en référençant BroadcastEvent.broadcastOfEvent et en spécifiant BroadcastEvent.location).
  • Regroupez la lecture en direct et la lecture de vidéo à la demande sur SportsEvent.potentialAction, soit en étendant availabilityEnds jusqu'à la fin de la fenêtre de vidéo à la demande si l'URL et les droits sont identiques, soit en fournissant plusieurs objets WatchAction dans SportsEvent.potentialAction avec leurs fenêtres actionAccessibilityRequirement respectives.
  • Ne fournissez pas BroadcastEvent.potentialAction, BroadcastEvent.url, SportsEvent.url ou BroadcastEvent.publishedOn.

Contrôles qualité à effectuer

  • Définissez BroadcastEvent.isLiveBroadcast sur la valeur booléenne true (sans guillemets) lorsque le match est diffusé en direct. Définissez-le sur false pour une rediffusion programmée.
  • Pour les entités BroadcastEvent qui ne sont pas actives, BroadcastEvent.startDate ne doit pas être antérieur à SportsEvent.startDate.
  • Incluez parentOrganization (avec une URL Wikipédia sameAs) sur homeTeam et awayTeam.
Cas 2

Je souhaite modéliser un SportsEvent qui fait partie de mon catalogue de télévision en direct et qui est diffusé en ligne sur une chaîne.

Entités requises

  • SportsEvent qui représente le jeu.
  • BroadcastEvent qui représente la diffusion du match.
  • Entités BroadcastService, Organization, TelevisionChannel, CableOrSatelliteService représentant la chaîne et la programmation.

Consignes de modélisation

Sous-cas 1 : Le match n'est disponible qu'en direct sur la chaîne linéaire (et ne fait pas partie du catalogue de vidéos à la demande)

  • Fournissez l'entité BroadcastEvent pour partager la programmation de la diffusion, avec BroadcastEvent.publishedOn pointant vers l'entité BroadcastService, BroadcastEvent.broadcastOfEvent pointant vers l'entité SportsEvent et BroadcastEvent.location spécifiant le pays de diffusion.
  • Fournissez les entités BroadcastService, Organization, TelevisionChannel et CableOrSatelliteService pour représenter la chaîne et la programmation, avec le lien profond de la chaîne sur BroadcastService.potentialAction.
  • Ne fournissez jamais BroadcastEvent.potentialAction, BroadcastEvent.url ou SportsEvent.url.
  • Si vous proposez également un lien profond direct spécifique au match, indiquez-le dans SportsEvent.potentialAction. Si la lecture n'est disponible que via le lien profond de la chaîne linéaire dans BroadcastService.potentialAction, omettez SportsEvent.potentialAction.

Sous-cas 2 : Le match est disponible en direct sur une chaîne et dans le catalogue de vidéos à la demande

  • Fournissez l'entité BroadcastEvent (avec publishedOn, broadcastOfEvent et location) pour partager la programmation de la chaîne.
  • Fournissez les entités BroadcastService, Organization, TelevisionChannel et CableOrSatelliteService, avec le lien profond de la chaîne sur BroadcastService.potentialAction.
  • Ne fournissez jamais BroadcastEvent.potentialAction, BroadcastEvent.url ou SportsEvent.url.
  • Indiquez SportsEvent.potentialAction sur l'entité SportsEvent pour la fenêtre de lecture au niveau de l'événement/de la vidéo à la demande.

Contrôles qualité à effectuer

  • Définissez BroadcastEvent.isLiveBroadcast sur la valeur booléenne true (sans guillemets) lorsque le match est en direct et sur false pour une rediffusion.
  • Pour les entités BroadcastEvent qui ne sont pas actives, BroadcastEvent.startDate ne doit pas être antérieur à SportsEvent.startDate.
  • Incluez parentOrganization (avec une URL Wikipédia sameAs) sur homeTeam et awayTeam.

Exemples

Cas 1 : Un événement sportif qui fait partie d'un catalogue de télévision en direct et qui est diffusé en ligne

Événement de diffusion

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live_event/basketball/professional/final_game_6",
  "name": "2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "description": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B.",
  "startDate": "2019-09-16T10:00-08:00",
  "endDate": "2019-09-16T13:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": true,
  "broadcastOfEvent": {
    "@type": "SportsEvent",
    "@id": "http://example.com/basketball/professional/final_game_6"
  },
  "location": {
    "@type": "Country",
    "name": "US"
  }
}

Événement sportif

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "name": "2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "sport": "https://en.wikipedia.org/wiki/Basketball",
  "description": {
    "@language": "en",
    "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
  },
  "startDate": "2019-09-16T10:00-08:00",
  "endDate": "2019-09-16T13:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "Jane Doe"
      }
    ]
  },
  "location": {
    "@type": "Place",
    "name": "Example Stadium",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "1600 Amphitheatre Pkwy",
      "addressLocality": "Mountain View",
      "addressRegion": "CA",
      "postalCode": "94043",
      "addressCountry": "US"
    }
  },
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value": "EP000194303282"
    }
  ],
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/pbl_finals_game_6?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": "2019-09-01T10:00-08:00",
      "availabilityEnds": "2019-09-16T16:00-08:00",
      "requiresSubscription": {
        "@type": "MediaSubscription",
        "name": "Example Package",
        "commonTier": true,
        "@id": "http://www.example.com/example_package"
      },
      "eligibleRegion": [
        {
          "@type": "Country",
          "name": "US"
        }
      ]
    }
  }
}

Cas 2 : Événement sportif faisant partie d'un catalogue de télévision en direct et diffusé en ligne sur une chaîne

Événement de diffusion

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "BroadcastEvent",
  "@id": "http://example.com/live_event/basketball/professional/final_game_6",
  "name": "2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "description": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B.",
  "startDate": "2019-09-16T10:00-08:00",
  "endDate": "2019-09-16T13:00-08:00",
  "videoFormat": "HD",
  "isLiveBroadcast": true,
  "publishedOn": {
    "@type": "BroadcastService",
    "@id": "http://example.com/stations/example_tv"
  },
  "broadcastOfEvent": {
    "@type": "SportsEvent",
    "@id": "http://example.com/basketball/professional/final_game_6"
  },
  "location": {
    "@type": "Country",
    "name": "US"
  }
}

Événement sportif

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "SportsEvent",
  "@id": "http://example.com/basketball/professional/final_game_6",
  "name": "2019 Professional Basketball Finals, Game 6: Team A at Team B",
  "sport": "https://en.wikipedia.org/wiki/Basketball",
  "description": {
    "@language": "en",
    "@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
  },
  "startDate": "2019-09-16T10:00-08:00",
  "endDate": "2019-09-16T13:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "Jane Doe"
      }
    ]
  },
  "location": {
    "@type": "Place",
    "name": "Example Stadium",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "1600 Amphitheatre Pkwy",
      "addressLocality": "Mountain View",
      "addressRegion": "CA",
      "postalCode": "94043",
      "addressCountry": "US"
    }
  },
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "TMS_ID",
      "value": "EP000194303282"
    }
  ]
}

Les entités BroadcastService, CableOrSatelliteService, TelevisionChannel et Organization telles que définies dans la section Chaîne de télévision en direct sous "Concepts".

Comment gérer les contenus supplémentaires ?

Qu'est-ce qu'un contenu supplémentaire ?
  • Récapitulatif aléatoire ou rediffusion de courts extraits
  • Aperçus du jeu
  • Temps forts du match
  • Bêtisier du jeu
  • Extraits d'interviews de joueurs
  • Vidéos des coulisses
  • Avis sur les jeux (générés par les utilisateurs ou non)
  • Autres extraits courts aléatoires du jeu
S.No. Cas d'utilisation Consignes de modélisation
Cas 1 Je dispose de contenus supplémentaires dans mon catalogue de vidéos à la demande.
  • Cette fonctionnalité n'est pas prise en charge et ne peut pas être fournie dans le flux.
  • ViTA peut toutefois être utilisé pour fournir un sous-ensemble de ce contenu. Contactez votre représentant Google pour en savoir plus sur ViTA.
Cas 2 Je propose des contenus supplémentaires dans mon catalogue en ligne

Sous-cas 1 : Le contenu est disponible en streaming en direct sur Internet

  • Fournissez l'entité BroadcastEvent pour partager la programmation de la diffusion.
  • Indiquez le lien profond du contenu supplémentaire à l'aide de la propriété BroadcastEvent.potentialAction (cette exception ne s'applique qu'au contenu supplémentaire autonome en direct, car il n'y a pas d'entité SportsEvent dans le flux).
  • Ajoutez toutes les métadonnées associées (au clip) directement à BroadcastEvent . Par exemple, vous pouvez ajouter des images à l'aide de la propriété BroadcastEvent.image . Vous pouvez ajouter des classifications par âge à l'aide de la propriété BroadcastEvent.contentRating .
  • Comme ce type de contenu n'est pas un SportsEvent, le flux ne doit pas contenir d'entité SportsEvent. Par conséquent, la propriété broadcastOfEvent de BroadcastEvent ne doit pas être fournie.
  • Comme il n'est pas associé à une chaîne, ne fournissez pas la propriété publishedOn sur BroadcastEvent.

Sous-cas 2 : Le contenu est disponible en streaming en direct sur Internet sur une chaîne

  • L'entité BroadcastEvent doit être fournie pour partager la programmation de la diffusion.
  • Les entités BroadcastService, Organization, TelevisionChannel et CableOrSatelliteService doivent être fournies pour représenter la chaîne et la liste des fournisseurs.
  • Le lien profond vers le jeu doit simplement être le lien profond BroadcastService , représenté par la propriété BroadcastService.potentialAction , qui doit être fournie.
  • La propriété BroadcastEvent.potentialAction ne doit pas être fournie.
  • Toutes les métadonnées associées à l'extrait doivent être ajoutées directement à l'élément BroadcastEvent. Par exemple, vous pouvez ajouter des images à l'aide de la propriété BroadcastEvent.image. Vous pouvez ajouter des classifications par âge à l'aide de la propriété BroadcastEvent.contentRating.
  • Comme ce type de contenu n'est pas un SportsEvent, le flux ne doit pas contenir d'entité SportsEvent. Par conséquent, la propriété broadcastOfEvent de BroadcastEvent ne doit pas être fournie.
  • Comme il est lié à un canal, fournissez la propriété publishedOn sur BroadcastEvent.
Cas 3 Je propose des contenus supplémentaires dans mes catalogues de vidéo à la demande et de télévision en direct

Étant donné que les contenus supplémentaires de sport en vidéo à la demande ne sont pas acceptés dans le flux aujourd'hui, ce cas est similaire au cas 2. Suivez les instructions qui s'affichent.

Questions fréquentes

Q : Où puis-je trouver les spécifications associées aux entités mentionnées précédemment ?

R : Vous trouverez les spécifications requises sur cette page.

Documentation générale Lien
SportsEvent Lien
BroadcastService, Organization, TelevisionChannel , CableOrSatelliteService Lien
BroadcastEvent Lien

Q : Existe-t-il un document plus détaillé expliquant comment modéliser les chaînes de télévision en direct et les bouquets ?

R : Oui, vous trouverez plus d'informations dans la section Chaîne de télévision en direct sous "Concepts". N'hésitez pas à demander un accès en lecture si vous ne parvenez pas à afficher le document.

Q : ViTA prend-il également en charge les matchs complets en direct et les rediffusions de matchs complets ?

R : ViTA accepte les métadonnées pour les matchs complets en direct et les rediffusions de matchs complets (en plus d'un sous-ensemble de contenus supplémentaires) pour les ligues.

  • Pour les partenaires qui disposent déjà d'un flux d'actions multimédias fonctionnel avec Google ou qui proposent une offre de vidéo à la demande ou de télévision en direct, Google exige que le flux soit étendu pour inclure également les types SportsEvent compatibles.

    • À court terme, les partenaires peuvent utiliser ViTA pour l'ingestion de contenus supplémentaires. La prise en charge de tous les types de contenus via le flux devrait être déployée à long terme.
  • Pour les partenaires qui ne proposent pas de vidéo à la demande ni de télévision en direct, mais qui ne diffusent que des sports de ligue et des contenus supplémentaires associés, ViTA est une excellente option pour commencer. Contactez votre représentant Google pour en savoir plus sur ViTA.