Verwaltung von Abschriften mit der CMS-API

In diesem Thema erfahren Sie, wie Sie die CMS-API zur Aktualisierung der Transkripte Ihrer Videos verwenden können.

Einleitung

Sie können eine PATCH Anfrage verwenden, um die den Transkripten zugeordneten Metadaten zu aktualisieren.

Hinweise

  • Die in diesem Dokument erläuterten Methoden dienen zur Aktualisierung der Ihren Videos hinzugefügten Transkriptionsdateien. Derzeit können Sie Brightcove haben Generieren Sie eine Transkriptdatei (zusammen mit Untertiteln) während der Einnahme. Das Einlesen eigener Transkriptionsdateien wird in einer zukünftigen Version unterstützt werden.

Autorisierung

Anfragen an die CMS-API erfordern einen Autorisierungsheader, der Ihre Zugriffstoken enthält. Ausführliche Informationen zum Abrufen von Client-Anmeldeinformationen und deren Verwendung zum Abrufen von Zugriffstoken finden Sie im Übersicht über Brightcove OAuth.

Die Vorgänge, die Sie zum Aktualisieren von Video-Metadaten benötigen, sind video-cloud/video/update oder video-cloud/video/all.

Syntax

Wir empfehlen, zuerst die folgende Anfrage zu stellen, um das vollständige Array zu erhalten:


GET
https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_ID}

Abschriften aktualisieren

Beim Aktualisieren von Abschriften können einige Felder in Abschriftenfeldern je nach Typ unterschiedlich behandelt werden.

Textspurfelder
Feld Typ Beschreibung
id Zeichenfolge SCHREIBGESCHÜTZTER Wert. Vom System generierte ID, die zur Identifizierung des zu aktualisierenden TT erforderlich ist.
account_id Zeichenfolge SCHREIBGESCHÜTZTER Wert. Aktualisierungen in diesem Feld werden ignoriert.
src Zeichenfolge NUR LESEN. Speicherort der Abschriftdatei.
srclang Zeichenfolge Sprachcode mit 2 oder 4 Buchstaben, z. B. es oder es-MX
label Zeichenfolge Von Menschen lesbares Etikett. Begrenzt auf 255 Zeichen.
status Aufzähung Gültige Werte (Groß- und Kleinschreibung beachten):
  • published- Transkripte werden den Zuschauern zur Verfügung stehen
  • draft- Die Transkripte werden den Zuschauern nicht zur Verfügung stehen
sources Reihe SCHREIBGESCHÜTZTER Wert. http und https URLs für das Transkript.
default Boolescher Wert true oder false. Sie können Transkripten nicht mehrere default=true hinzufügen, wenn sie unterschiedlich sind srclang.

Aktualisierungen in diesem Feld werden ignoriert.

Anfrage

PATCH https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_ID} 

Beispiel für einen Anfragetext

Der Anfragekörper ist ein JSON-Objekt, das ein Array von Transkripten enthält:

"transcripts": [
  {
      "id": "d5967d03-1de1-a2de-47db-73486c7474c1",
      "account_id": "12345678910",
      "src": "https://bcboltqause1-a.akamaihd.net/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/d5967d03-1de1-47db-a2de-774c3486c741/transcript.txt?akamai_token=exp=1656544942~acl=/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/d5967d03-1de1-47db-a2de-774c3486c741/transcript.txt*~hmac=101a93fa0e0d247194de3c128460d457d4eea7a27d270a1f8509c2c00205af10",
      "srclang": "en-IE",
      "label": "Irish English",
      "status": "draft",
      "sources": [
          "https://bcboltqause1-a.akamaihd.net/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/d5967d03-1de1-47db-a2de-774c3486c741/transcript.txt?akamai_token=exp=1656544942~acl=/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/d5967d03-1de1-47db-a2de-774c3486c741/transcript.txt*~hmac=101a93fa0e0d247194de3c128460d457d4eea7a27d270a1f8509c2c00205af10",
          "https://bcboltqause1-a.akamaihd.net/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/d5967d03-1de1-47db-a2de-774c3486c741/transcript.txt?akamai_token=exp=1656544942~acl=/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/d5967d03-1de1-47db-a2de-774c3486c741/transcript.txt*~hmac=101a93fa0e0d247194de3c128460d457d4eea7a27d270a1f8509c2c00205af10"
      ],
      "default": false
  },
  {
      "id": "2d0cb632-8753-a68a-4143-aea0429eac7f",
      "account_id": "12345678910",
      "src": "https://bcboltqause1-a.akamaihd.net/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/2d0cb632-a68a-4143-8753-aea0429eac7f/transcript.txt?akamai_token=exp=1656544942~acl=/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/2d0cb632-a68a-4143-8753-aea0429eac7f/transcript.txt*~hmac=8ae7069ac9717559e9439f5112ee133d955ec18a09563e7a3e2a48a83637c108",
      "srclang": "en-US",
      "label": "American English",
      "status": "draft",
      "sources": [
          "https://bcboltqause1-a.akamaihd.net/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/2d0cb632-a68a-4143-8753-aea0429eac7f/transcript.txt?akamai_token=exp=1656544942~acl=/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/2d0cb632-a68a-4143-8753-aea0429eac7f/transcript.txt*~hmac=8ae7069ac9717559e9439f5112ee133d955ec18a09563e7a3e2a48a83637c108",
          "https://bcboltqause1-a.akamaihd.net/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/2d0cb632-a68a-4143-8753-aea0429eac7f/transcript.txt?akamai_token=exp=1656544942~acl=/media/v1/text/txt/clear/12345678910/c6359761-86f7-70d6-4b98-f11f5bb98475/2d0cb632-a68a-4143-8753-aea0429eac7f/transcript.txt*~hmac=8ae7069ac9717559e9439f5112ee133d955ec18a09563e7a3e2a48a83637c108"
      ],
      "default": false
  }
]