Métadonnées multilingues

Cette rubrique fournit une vue d'ensemble de l'ajout de métadonnées multilingues aux vidéos destinées aux spectateurs qui parlent différentes langues. Les métadonnées multilingues sont particulièrement importantes pour Balise de Brightcove clients, mais peut être utilisé avec les vidéos Video Cloud en général.

Introduction

Si vous avez un public international (ou multilingue dans le même pays), vous souhaiterez peut-être fournir des métadonnées vidéo telles que le titre et la description dans plusieurs langues.

Video Cloud autorise les versions multilingues des éléments suivants :

images
pistes de texte
nom (via variants)
la description variants)
longue description variants)
valeurs de champs personnalisés variants)

Création d'une variante

En utilisant le CMS API (Créer une variante vidéo ) vous pouvez ajouter et gérer un tableau de variants pour fournir une alternative name , description , long_description et carte des champs / valeurs personnalisés spécifiques à une langue.

Pour créer une variante, envoyez un POST demande au point de terminaison :

https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/variants/

{
  "language": "ja-JA",
  "name": "バーゼル：ライン川",
  "description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
  "long_description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
  "custom_fields": {
    "language": "Japanese"
  }
}

Exemple de réponse

{
  "language": "ja-JA",
  "name": "バーゼル：ライン川",
  "description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
  "long_description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
  "custom_fields": {
    "language": "Japanese"
  }
}

Obtenir des variantes

Obtenez toutes les variantes

Vous pouvez obtenir toutes les variantes d'une vidéo en envoyant un GET demande au point de terminaison :

https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/variants

Exemple de réponse

[
  {
    "language": "es-ES",
    "name": "Basilea: el Rin",
    "description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
    "long_description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
    "custom_fields": {
    }
  },
  {
    "language": "de-DE",
    "name": "Basel: Der Rhein",
    "description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
    "long_description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
    "custom_fields": {
    }
  },
  {
    "language": "ja-JA",
    "name": "バーゼル：ライン川",
    "description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
    "long_description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
    "custom_fields": {
      "language": "Japanese"
    }
  }
  ]

Obtenir une variante particulière

Pour obtenir une variante particulière, envoyez un GET demande au point de terminaison :

https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/variants/{language}

Ici language est le code de langue utilisé dans la variante, tel que de-DE.

Exemple de réponse

{
  "language": "de-DE",
  "name": "Basel: Der Rhein",
  "description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
  "long_description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
  "custom_fields": {
  }
}

Mettre à jour une variante

Vous pouvez mettre à jour une variante en envoyant un PATCH demande au point de terminaison :

https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/variants/{language}

Ici language est le code de langue utilisé dans la variante, tel que de-DE.

Vous n'avez qu'à inclure les champs qui changent. Les champs du corps de la requête sont les mêmes que pour la création d'une variante, sauf que vous pouvez ne pas inclure le language domaine. (Si vous incluez le language field une VALIDATION_ERROR sera retourné.)

Exemple de corps de requête

{
  "name": "Basilea: el Rin",
  "description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
  "long_description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
  "custom_fields": {
    "language": "Spanish"
 }
}

Exemple de réponse

{
  "language": "es-ES",
  "name": "Basilea: el Rin",
  "description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
  "long_description": "Vista panorámica del Rin en el centro de Basilea, Suiza.",
  "custom_fields": {
    "language": "Spanish"
  }
}

Supprimer une variante

Pour supprimer une variante, envoyez un DELETE demande au point de terminaison :

https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/variants/{language}

N'incluez pas de corps de requête. Une suppression réussie renverra un 204 No Content réponse.

Les variantes peuvent être récupérées à l'aide de l'API Playback ainsi que de l'API CMS. Dans l'API de lecture, ils sont renvoyés lorsque vous obtenez une vidéo, en tant que niveau supérieur variants déployer:

"variants": [
  {
    "language": "de-DE",
    "name": "Basel: Der Rhein",
    "description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
    "long_description": "Panoramablick auf den Rhein im Zentrum von Basel, Schweiz.",
    "custom_fields": {}
  },
  {
    "language": "ja-JA",
    "name": "バーゼル：ライン川",
    "description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
    "long_description": "スイス、バーゼルの中心部にあるライン川のパノラマビュー。",
    "custom_fields": {
      "language": "Japanese"
    }
  }
]

Images et pistes de texte

Des images et des pistes de texte pour d'autres langues peuvent être ajoutées à l'aide de l'API Dynamic Ingest. Pour plus de détails, consultez les rubriques suivantes :