Aggiornare un video

Aggiornare un video richiede il permesso videos.update. Il campo visibility viene scritto solo quando la chiave ha videos.publish. Altrimenti il campo resta invariato e la risposta resta 200. Vedi Autenticazione.

Aggiorna video

Per aggiornare un singolo video, invia una richiesta PATCH all’endpoint /videos/:id.

Se cerchi un modo per sostituire un file video, consulta la sezione sostituire video.

Campi scrivibili

Campo	Note
`title`	Obbligatorio quando lo invii. Spazi rimossi. Da 1 a 150 caratteri.
`description`	Massimo 2000 caratteri.
`language`	Locale della lingua parlata, per esempio `en-US`. Anche altre stringhe vengono salvate.
`aiContent`	`none`, `generated` o `modified`.
`visibility`	Scritto solo con `videos.publish`. Altrimenti il campo resta invariato.
`categories`	Sostituisce la lista. Gli id sconosciuti vengono scartati. Se non ne resta nessuno, il campo è `null`.
`tags`	Sostituisce la lista. Gli id sconosciuti vengono scartati. Se non ne resta nessuno, il campo è `null`.
`customMetadata`	Unisce i campi all’oggetto salvato. Vedi l’oggetto video.
`chapters`	`title` (max 100) e `timestamp` nel formato `HH:MM:SS`.
`autoTranscription.autoStart`	Avvia la trascrizione dopo la codifica successiva quando è `true`.
`player.useCustomDesign`	Usa `player.playerDesign` al posto del preset.
`player.selectedPreset`	Id del preset del player, o `null`.
`player.playerDesign`	Proprietà di design del player. Vedi l’oggetto video.
`passwordProtection`	`{ enabled, password }`. `password` ha almeno 8 caratteri. Scritto solo quando il workspace ha la protezione con password.

status, texttracks, audiotracks e i campi file vengono ignorati. Invia le modifiche ai Text track agli endpoint Text track.

CURL


curl -X PATCH https://app.ignitevideo.cloud/api/videos/[VIDEO_ID] \ 
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"title": "New video title"}'

JavaScript / Node.js


const dataToUpdate = {
  "title": "New video title"
}
const response = await fetch(`https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]`, {
  method: 'PATCH',
  body: JSON.stringify(dataToUpdate),
  headers: {
    'Authorization': `Bearer YOUR_TOKEN`,
    'Content-Type': 'application/json'
  }
});

PHP


$client = new GuzzleHttp\Client();
$dataToUpdate = [
  "title" => "New video title"
];
$response = $client->request('PATCH', 'https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]', [
  'body' => json_encode($dataToUpdate),
  'headers' => [
    'Authorization' => 'Bearer YOUR_TOKEN',
    'Content-Type' => 'application/json'
  ]
]);

Risposta

La risposta è un oggetto che contiene l’oggetto video e un messaggio di aggiornamento. Se l’id non esiste, la risposta è 403 con l’errore Payload. Un id mancante e un id vietato restituiscono lo stesso corpo. Vedi Autenticazione.


{
  doc: {
    "id": "[VIDEO_ID]",
    "title": "New video title",
    ...
  },
  message: "Updated successfully."
}