Videos aktivieren/deaktivieren oder planen

In diesem Thema wird gezeigt, wie Sie ein Video mithilfe von aktivieren, deaktivieren oder planen CMS API.

Einleitung

Es gibt mehrere Gründe, warum Sie ein Video erst einige Zeit später unspielbar machen möchten. Zum Beispiel:

  • Es wird noch überprüft
  • Es ist ein Trailer für einen Film, der noch nicht veröffentlicht wurde
  • Es ist Teil einer Marketingkampagne, die noch nicht begonnen hat oder beendet ist
  • Es ist Teil einer noch nicht veröffentlichten Nachrichtengeschichte

Wenn Sie den Video-Einbettungscode noch nicht in eine öffentliche Seite oder App eingefügt haben, kann er natürlich nicht angezeigt werden, aber es gibt Möglichkeiten, ein Video versehentlich zu veröffentlichen. Der offensichtlichste ist, dass seine Tags oder andere Eigenschaften zu einem Smart passen Playlist, die veröffentlicht wird.

Es gibt zwei Möglichkeiten, um sicherzustellen, dass ein Video Cloud-Video nicht angezeigt werden kann:

  • Deaktivieren Sie es
  • Planen Sie es so, dass es irgendwann in der Zukunft spielbar ist

Beide Änderungen können über das Medienmodul in Studio implementiert werden. Hier erfahren Sie jedoch, wie Sie sie mit dem implementieren CMS API. Beide Aktionen werden mithilfe einer Videoaktualisierungsanforderung ausgeführt.

Authentifizierung

Anfragen an die CMS API benötigen 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.

Sie können Client-Anmeldeinformationen erstellen, indem Sie die Studio-Admin-Seiten oder der OAuth-API

Sie können auch die OAuth-API direkt, um Zugriffstoken abzurufen, oder wenn Sie die Postbote oder Schlaflosigkeit app oder stellen Sie Ihre Anfragen, lesen Sie unsere Tutorials zum Einrichten dieser zum Abrufen von Zugriffstoken:

Die Update-Video-Anfrage

Um ein Video zu aktualisieren, senden Sie eine PATCH Anfrage an

https://cms.api.brightcove.com/v1/accounts/account_id/videos/video_id

Im Allgemeinen muss der Anforderungstext nur die Felder enthalten, die Sie aktualisieren möchten, Sie können jedoch auch andere mit den aktuellen Werten einschließen. In den folgenden Abschnitten werden wir uns die Antragsstellen für die Aktivierung/Deaktivierung und die Planung ansehen.

Ein Video aktivieren/deaktivieren

Ein Video wird aktiv (sichtbar) oder inaktiv (nicht sichtbar) gemacht, indem es eingestellt wird state. Standardmäßig werden Videos aufgenommen, ACTIVE sobald sie aufgenommen wurden (es sei denn, es gibt Pflichtfelder, die bei der Erstellung des Videos weggelassen oder mit dem Upload-Modul hochgeladen wurden).

Um ein Video dann zu deaktivieren, müssen Sie nur den folgenden Request-Body mit der Update-Video-Anfrage senden:

{
  "state": "INACTIVE"
}

Sie können überprüfen, ob das Video jetzt inaktiv ist, indem Sie das state Feld in der API-Antwort überprüfen

Beispielantwort 
{
  "id": "1698990613556232930",
  "account_id": "57838016001",
  "ad_keys": null,
  "clip_source_video_id": null,
  "complete": true,
  "created_at": "2021-05-06T06:48:31.963Z",
  "created_by": {
    "type": "unknown"
  },
  "cue_points": [
  ],
  "custom_fields": {
  },
  "delivery_type": "dynamic_origin",
  "description": "Updated at: 2021-05-07T22:37:46.492Z",
  "digital_master_id": null,
  "duration": 41259,
  "economics": "AD_SUPPORTED",
  "folder_id": null,
  "geo": null,
  "has_digital_master": true,
  "images": {
    "poster": {
      "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/1494916a-e8a7-45ac-882f-6e0aa3489846/main/1280x720/20s629ms/match/image.jpg",
      "sources": [
        {
          "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/1494916a-e8a7-45ac-882f-6e0aa3489846/main/1280x720/20s629ms/match/image.jpg",
          "height": 720,
          "width": 1280
        }
      ]
    },
    "thumbnail": {
      "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/1494916a-e8a7-45ac-882f-6e0aa3489846/main/160x90/20s629ms/match/image.jpg",
      "sources": [
        {
          "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/1494916a-e8a7-45ac-882f-6e0aa3489846/main/160x90/20s629ms/match/image.jpg",
          "height": 90,
          "width": 160
        }
      ]
    }
  },
  "link": null,
  "long_description": null,
  "name": "Great Horned Owl",
  "original_filename": "greathornedowl.mp4",
  "projection": null,
  "published_at": "2021-05-06T06:48:31.963Z",
  "reference_id": "greathornedowl.mp4_1620283704192",
  "schedule": null,
  "sharing": null,
  "state": "INACTIVE",
  "tags": [
    "bird",
    "air",
    "nature"
  ],
  "text_tracks": [
  ],
  "updated_at": "2021-05-16T22:54:09.168Z",
  "updated_by": {
    "type": "api_key",
    "email": "rcrooks@brightcove.com"
  },
  "offline_enabled": false,
  "playback_rights_id": "primary"
}

Um das Video wieder aktiv zu machen, senden Sie einfach eine weitere Update-Video-Anfrage mit dem Anfragetext:

{
  "state": "ACTIVE"
}

Planen Sie ein Video

Die zweite Möglichkeit, ein Video abspielbar oder unabspielbar zu machen, besteht darin, das schedule Objekt in der Videoaktualisierungsanforderung zu verwenden. Das schedule object has two properties:

  • starts_at das ISO-8601-Datum, an dem das Video abspielbar wird (erforderlich)
  • ends_at das ISO-8601-Datum, an dem das Video nicht mehr abgespielt werden kann (optional)

Hier ist ein Beispiel für einen Anforderungstext, der ein Video am 16. Mai 2021 um 6:00 Uhr (UTC) abspielbar macht und es genau ein Jahr später wieder unspielbar macht:

{
  "schedule": {
		"starts_at": "2021-05-16T06:00:00.000Z",
		"ends_at": "2022-05-16T06:00:00.000Z"
	}
}
Beispielantwort 
{
  "id": "1698990613556232930",
  "account_id": "57838016001",
  "ad_keys": null,
  "clip_source_video_id": null,
  "complete": true,
  "created_at": "2021-05-06T06:48:31.963Z",
  "created_by": {
    "type": "unknown"
  },
  "cue_points": [
  ],
  "custom_fields": {
  },
  "delivery_type": "dynamic_origin",
  "description": "Updated at: 2021-05-07T22:37:46.492Z",
  "digital_master_id": null,
  "duration": 41259,
  "economics": "AD_SUPPORTED",
  "folder_id": null,
  "geo": null,
  "has_digital_master": true,
  "images": {
    "poster": {
      "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/1494916a-e8a7-45ac-882f-6e0aa3489846/main/1280x720/20s629ms/match/image.jpg",
      "sources": [
        {
          "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/1494916a-e8a7-45ac-882f-6e0aa3489846/main/1280x720/20s629ms/match/image.jpg",
          "height": 720,
          "width": 1280
        }
      ]
    },
    "thumbnail": {
      "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/1494916a-e8a7-45ac-882f-6e0aa3489846/main/160x90/20s629ms/match/image.jpg",
      "sources": [
        {
          "src": "https://cf-images.us-east-1.prod.boltdns.net/v1/jit/57838016001/1494916a-e8a7-45ac-882f-6e0aa3489846/main/160x90/20s629ms/match/image.jpg",
          "height": 90,
          "width": 160
        }
      ]
    }
  },
  "link": null,
  "long_description": null,
  "name": "Great Horned Owl",
  "original_filename": "greathornedowl.mp4",
  "projection": null,
  "published_at": "2021-05-06T06:48:31.963Z",
  "reference_id": "greathornedowl.mp4_1620283704192",
  "schedule": {
    "ends_at": "2022-05-16T06:00:00.000Z",
    "starts_at": "2021-05-16T06:00:00.000Z"
  },
  "sharing": null,
  "state": "ACTIVE",
  "tags": [
    "bird",
    "air",
    "nature"
  ],
  "text_tracks": [
  ],
  "updated_at": "2021-05-17T00:42:45.172Z",
  "updated_by": {
    "type": "api_key",
    "email": "rcrooks@brightcove.com"
  },
  "offline_enabled": false,
  "playback_rights_id": "primary"
}