Introduction
Si vous avez un international audience (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 en 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 champ personnalisées
variants
)
Créer une variante
En utilisant l' CMS API (Créer une variante vidéo), vous pouvez ajouter et gérer un tableau de variants
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 final:
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 final:
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"
}
}
]
Obtenez une variante particulière
Pour obtenir une variante particulière, envoyez un GET
demande au point final:
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 fr-fr.
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 final:
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 fr-fr.
Vous devez uniquement 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 tu peux ne sont pas inclure language
champ. (Si vous incluez le language field
a 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 final:
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 du Playback API la CMS API. Dans le Playback API, ils sont renvoyés lorsque vous recevez une vidéo, en tant que variants
tableau:
"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 à Dynamic Ingest API. Pour plus de détails, consultez les rubriques suivantes: