Video aktualisieren

Zum Aktualisieren eines Videos brauchst du die Berechtigung videos.update. visibility wird nur geschrieben, wenn der Key videos.publish hat. Sonst bleibt das Feld unverändert, und die Antwort bleibt 200. Siehe Authentifizierung.

Video aktualisieren

Ein einzelnes Video aktualisierst du mit einer PATCH-Anfrage an den Endpoint /videos/:id.

Wenn du die Videodatei ersetzen willst, siehe den Abschnitt Video ersetzen.

Beschreibbare Felder

Feld	Hinweise
`title`	Erforderlich, wenn gesendet. Getrimmt. 1 bis 150 Zeichen.
`description`	Maximal 2000 Zeichen.
`language`	Locale der gesprochenen Sprache, zum Beispiel `en-US`. Andere Strings werden ebenfalls gespeichert.
`aiContent`	`none`, `generated` oder `modified`.
`visibility`	Wird nur mit `videos.publish` geschrieben. Sonst bleibt das Feld unverändert.
`categories`	Ersetzt die Liste. Unbekannte Ids werden verworfen. Bleibt keine übrig, ist das Feld `null`.
`tags`	Ersetzt die Liste. Unbekannte Ids werden verworfen. Bleibt keine übrig, ist das Feld `null`.
`customMetadata`	Wird mit dem gespeicherten Objekt zusammengeführt. Siehe das Video-Objekt.
`chapters`	`title` (max. 100) und `timestamp` als `HH:MM:SS`.
`autoTranscription.autoStart`	Startet die Transkription nach dem nächsten Encoding, wenn `true`.
`player.useCustomDesign`	`player.playerDesign` statt des Presets verwenden.
`player.selectedPreset`	Id des Player-Presets oder `null`.
`player.playerDesign`	Eigenschaften des Player-Designs. Siehe das Video-Objekt.
`passwordProtection`	`{ enabled, password }`. `password` hat mindestens 8 Zeichen. Wird nur geschrieben, wenn der Workspace Passwortschutz hat.

status, texttracks, audiotracks und Dateifelder werden ignoriert. Sende Änderungen an Text tracks an die Text track-Endpoints.

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'
  ]
]);

Antwort

Die Antwort ist ein Objekt mit dem Video-Objekt und einer Aktualisierungsmeldung. Wenn die Id nicht existiert, ist die Antwort 403 mit dem Payload-Fehler. Eine fehlende Id und eine verbotene Id liefern denselben Body. Siehe Authentifizierung.


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