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.
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):
|
|
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
}
]