Aktualizacja wideo

Aktualizacja wideo wymaga uprawnienia videos.update. visibility jest zapisywane tylko wtedy, gdy klucz ma videos.publish. W przeciwnym razie pole pozostaje bez zmian, a odpowiedź pozostaje 200. Zobacz Uwierzytelnianie.

Aktualizacja wideo

Aktualizację pojedynczego wideo realizujesz przez wysłanie żądania PATCH do endpointu /videos/:id.

Jeśli szukasz sposobu na zastąpienie pliku wideo, zobacz sekcję zastąp wideo.

Pola do zapisu

Pole	Uwagi
`title`	Wymagane, gdy jest wysyłane. Przycinane. Od 1 do 150 znaków.
`description`	Maksimum 2000 znaków.
`language`	Locale języka mówionego, na przykład `en-US`. Inne ciągi też są zapisywane.
`aiContent`	`none`, `generated` albo `modified`.
`visibility`	Zapisywane tylko z `videos.publish`. W przeciwnym razie pole pozostaje bez zmian.
`categories`	Zastępuje listę. Nieznane identyfikatory są odrzucane. Jeśli nie zostanie żaden identyfikator, pole ma wartość `null`.
`tags`	Zastępuje listę. Nieznane identyfikatory są odrzucane. Jeśli nie zostanie żaden identyfikator, pole ma wartość `null`.
`customMetadata`	Scala się z zapisanym obiektem. Zobacz obiekt wideo.
`chapters`	`title` (maks. 100) i `timestamp` jako `HH:MM:SS`.
`autoTranscription.autoStart`	Uruchom transkrypcję po następnym kodowaniu, gdy wartość to `true`.
`player.useCustomDesign`	Użyj `player.playerDesign` zamiast presetu.
`player.selectedPreset`	Id presetu odtwarzacza albo `null`.
`player.playerDesign`	Właściwości designu odtwarzacza. Zobacz obiekt wideo.
`passwordProtection`	`{ enabled, password }`. `password` ma co najmniej 8 znaków. Zapisywane tylko, gdy workspace ma ochronę hasłem.

status, texttracks, audiotracks i pola plików są ignorowane. Zmiany text track wysyłaj do endpointów 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'
  ]
]);

Odpowiedź

Odpowiedź to obiekt zawierający obiekt wideo i komunikat aktualizacji. Jeśli id nie istnieje, odpowiedź to 403 z błędem Payload. Brakujące id i zabronione id zwracają tę samą treść. Zobacz Uwierzytelnianie.


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