L’upload groupé permet d’importer des contenus ou des métadonnées (titre, description, mots-clés, casting etc…) en une seule fois.  A noter: pour le moment nous limitons les uploads à 25 éléments maximum par envoi.

Pour cela il faut créer des fichiers JSON en respectant la structure ci-dessous.

Les objets définis sont communs à tous vos projets au sein de votre organisation.

 

Objects Structure

Par souci de simplicité, l’unicité de l’objet et la dépendance entre les objets sont réalisées en utilisant le LABEL ou la clé de l’objet comme clé unique.

  • MULTI-LANGUES
    • Chaque fichier d’importation possède une langue par défaut définie globalement pour tous les objets : « default_language » (langue par défaut)
    • Chaque objet a plusieurs supports linguistiques (pour le nom, la description, la biographie… mais pas le label qui est unique) via des traductions avec le code pays ALPHA2 (cf https://www.iban.com/country-codes):
"translations" :
[
  {
    "language": "fr",
    // LIST OF PARAMETERS FOR THIS OBJECT
  },
  {
    "language": "en",
    // LIST OF PARAMETERS FOR THIS OBJECT
  }
]
  • IMAGES
    • Les objets peuvent supporter jusqu’à 4 tailles d’images par traduction. Chaque fichier est censé être disponible sur le bucket S3. Format de support : jpeg / png
"pictures": 
  {
   "16_6_s3_location": "s3://my_bucket_url/my_picture_16_6.jpg",
   "16_9_s3_location": "s3://my_bucket_url//my_picture_16_9.jpg",
   "4_3_s3_location": "s3://my_bucket_url//my_picture_4_3.jpg",
   "1_1_s3_location": "s3://my_bucket_url//my_picture_1_1.jpg" 
}
  • COPYRIGHT
    • key : text (255)
  • CASTING
    • label: text (255)
    • name: text (255)
    • biography (optional): markdown (2046)
    • pictures (optional): 1_1
  • MEDIA
    • label: text (255)
    • media_S3_location (optional): path on S3 bucket
    • type: audio / video
    • storage : hosted / live
    • geoblock_mode (optional): disabled, allow, deny
    • media_countries (for geoblock – optional): array of ALPHA2 country code 
    • temporal_restriction (optional)
      • begin_date: yyyy-mm-dd hh:mm:ss
      • end_date:  yyyy-mm-dd hh:mm:ss
    • duration (in seconds – optional) : integer
    • isan_code (optional): ISAN 0000-0001-8947-0000-8-0000-0000-D
    • isrc_code (optional): ISRC FR-Z11-92-20350
    • eidr_code (optional): 10.5240/3202-A3F9-0937-E9DC-7B21-9
    • custom_id (optional): text (255)
    • production_date (optional): yyyy-mm-dd
    • publication_date (optional): yyyy-mm-dd
    • copyright: text (255) // must match existing copyright key
    • title: text (255)
    • description (optional): markdown (2046) 
    • short_description (optional): markdown (2046)
    • pictures (optional) : 1_1, 16_9, 16_6, 3_4
    • media_castings (optional): array of type casting label // must match existing casting label
      • type // actor, director, author, producer
    • genre (optional): text from this list, warning: case sensitive
      • action, advanced, music, men, show, tutorial, 2t, science, natural, other, polonaise, documentary, intermediate, society, animation, 3t, human, sport, mazurka, horror, discovery, history, arts, adventure, culture, waltz, comedy, baby, film, 6t, scienceFiction, affairs, drame, performance, 4t, coda, ragtime, interview, thriller, beginner, adult
    • category (optional): text from this list, warning: case sensitive
      • techsolution, ballet, dancejazz, class, repertoire, series, barre, hiphop, film, collection, character, music, bonus, shortProgram, trailer, contemporary, others, project
    • keywords (optional): text array (255)
  • S3 CREDENTIALS (OPTIONAL):
    • s3_credentials
    • s3_access_key
    • s3_secret_key
    • s3_bucket_url
    • s3_bucket_region: as defined per AWS

Exemple

 {
  "default_language": "FR",
  "castings": [
    {
      "label": "John Doe",
      "translations" : [
        {
          "language": "fr",
          "name": "John Doe",
          "biography": "Personne inconnue"
        },
        {
          "language": "en",
          "name": "John Doe",
          "biography": "unknown person",
          "pictures": {
             "1_1_s3_location": "s3://my_bucket_url/johndoe_1_1.jpg"
          }
        }
      ]
    },
    {
      "label": "Mickey",
      "translations" : [
        {
          "language": "fr",
          "name": "Mickey",
          "biography": "Une souris célèbre"
        }
      ]
    }
  ],
  "copyright": [
    {
      "key": "OKAST"
    }
  ],
  "medias": [
    {
      "label": "Great movie",
      "media_s3_location": "s3://my_bucket_url/my_great_movie.mp4",
      "type": "video",
      "storage": "hosted",
      "geoblock_mode": "allow",
      "media_countries": ["FR", "GB"],
      "temporal_restriction": {
        "begin_date": "2018-01-23 00:00:00",
        "end_date": "2018-01-25 00:00:00"
      },
      "duration": 900,
      "isan_code": "ISAN 0000-0001-8947-0000-8-0000-0000-D",
      "isrc_code": "ISRC FR-Z11-92-20350",
      "eidr_code": "10.5240/3202-A3F9-0937-E9DC-7B21-9",
      "custom_id": "xxxx",
      "production_date": "2042-01-01",
      "publication_date": "2042-01-01",
      "copyright": "OKAST",
      "translations": [
        {
          "language": "fr",
          "title": "Un grand film",
          "description": "Un grand film avec de grands acteurs",
          "short_description": "Un grand film",
          "pictures": {
            "16_6_s3_location": "s3://my_bucket_url/my_great_movie_16_6.jpg",
            "16_9_s3_location": "s3://my_bucket_url/my_great_movie_16_9.jpg",
            "4_3_s3_location": "s3://my_bucket_url/my_great_movie_4_3.jpg",
            "1_1_s3_location": "s3://my_bucket_url/my_great_movie_1_1.jpg"
          }
        },
        {
          "language": "en",
          "title": "A great movie",
          "description": "A great movie with great actors",
          "short_description": "A great movie"
        }
      ],
      "media_castings" : {
        "actor": [
          "John Doe",
          "Mickey"
        ],
        "director": [
          "John Doe"
        ],
        "producer": [
          "John Doe"
        ],
        "author": [
          "Mickey"
        ]
      },
      "genre": "action",
      "category": "series",
      "keywords": ["pop", "yoga", "animation"]
    }
  ],
  "s3_credentials": {
    "s3_access_key": "lksjdfkljqslkdjlksqjd",
    "s3_secret_key": "lkjhdfkjhfksjfsd",
    "s3_bucket_url": "s3://my_bucket_url",
    "s3_bucket_region": "eu-west-3"
  }
}

LIMITATIONS:

  • Les sous-titres ne sont pas disponibles ;
  • les fichiers audio mp3 ne doivent pas contenir de couverture (cover), sinon l’encodage ne démarre pas ;
  • les pistes audio multiples ne sont pas disponibles.

 

Comment télécharger en vrac à partir de l’éditeur

Rendez-vous sur le menu Gestion des contenus > Imports (le menu n’est pas activé pour tous les utilisateurs, si vous ne voyez pas le menu de votre back-office, demandez à votre contact commercial).

Puis cliquez sur le bouton « Créer un nouvel import » :

Une fois que votre fichier .JSON est prêt (comme expliqué ci-dessus), cliquez sur « Upload a JSON file » :

Le fichier sera d’abord analysé et le système analysera combien de contenus et/ou de crédits sont détectés.

 

En cas d’erreur, le système vous indiquera à quel endroit si vous cliquez sur le bouton « Détails » :

 

Une fois que votre fichier est prêt à être ingéré, il suffit de cliquer sur « Start Ingest » et l’importation commencera : le contenu et les crédits seront créés et ajoutés automatiquement sur votre plateforme.  Vous pouvez télécharger un rapport (un fichier CSV) pour avoir plus d’informations via le bouton « Télécharger le rapport ».

 

Pour toute question, veuillez nous contacter à l’adresse suivante : hello@okast.tv