Modifier les métadonnées des médias ingérés

Modifié le  Wed, 19 Jul 2023 sur 11:18 AM



Change history:
Initial version     08-23-2022         Initial version


Étude de cas :

  • Modifier les métadonnées des médias importés depuis un stockage tiers
    • AWS S3
    • Azure Blob storage
    • Autres … 


  • Modifier les métadonnées, sans passer par l’interface d’administration Okast Channels


  • Automatisation de la modification des métadonnées, des médias stockés sur l’instance 




Synoptique de fonctionnement du webservice.


1) Les limitations :

  • Etre client Okast.
  • Avoir une instance Okast channels + ses credentials.
  • Un appel par instance possédée.



2) Syntaxe d'usage pour _updateMetadata

L'URL d'appel est la suivante > 

http://<URL_de_mon_instance>/playlist/manager/php/_updateMetadata.php


Parameters

ParameterFormatsDescriptionMandatory
filePathURLLien HTTPS vers le fichier média (.MP4) distant à importer et ingérerYes
metadataPatchURLLien HTTPS vers le fichier de métadata (.JSON) distant à importer et traiterYes


Exemple

https://okast.easytools.tv/synthesia/okast-channels/playlist/manager/php/_updateMetadata.php?
filePath=http%3A%2F%2Fmydomain.fr%2Fmedias%2FBigBuckBunny-1080p.mp4
&metadataPath=http%3A%2F%2Fmydomain.fr%2Fmetadata%2FBigBuckBunny-1080p-metadata-updated.json


Structure de métadonnée .JSON > PDF en bas de l'article


Metadata JSON exemple

[
   {
      "tag":"1997-01193_136_22640187",
      "title":"Media title",
      "subtitle":"Media subtitle",
      "description":"Media description, write here the full description of the media",
      "season":0,
      "episode":136,
      "category":"COMEDY",
      "host":"",
      "hostFunction":"",
      "host2":"",
      "host2Function":"",
      "host3":"",
      "host3Function":"",
      "showName":"Write the Show Name",
      "dateDay":1,
      "dateMonth":1,
      "dateYear":1994,
      "imageLink":"",
      "country":"France",
      "classification":"Tout public",
      "isrc":"",
      "isan":"",
      "plurimedia":"",
      "internal":null,
      "internalRef":"",
      "comments":"Write here comment on yout media",
      "hasOverlay":1,
      "oeCategory":"",
      "keywords":"A0000000",
      "siteUrl":"",
      "qrUrl":"",
      "qrTitle":"",
      "qrDescription":"",
      "qrInvite":"",
      "validityFromDay":9,
      "validityFromMonth":8,
      "validityFromYear":2022,
      "validityFromHour":14,
      "validityFromMinute":26,
      "validityToDay":9,
      "validityToMonth":11,
      "validityToYear":2022,
      "validityToHour":14,
      "validityToMinute":26
   }
]