Übersicht: Soziale API

Einführung

Die Social API ermöglicht es Ihnen, den Social-Sharing-Status und den Verlauf für Ihre Videos zu erhalten. Es soll hauptsächlich bei CMS-Integrationen helfen, damit Ihre Benutzer diese Informationen in Ihrem eigenen CMS-System anzeigen können.

Vollständige Details zu Anfragen finden Sie in der API-Referenz.

Basis-URL

Die Basis-URL für die API lautet:

  https://edge.social.api.brightcove.com/v1

Authentifizierung

Die Authentifizierung für Anfragen erfordert Authorization header :

        Authorization: Bearer {access_token}

Der access_token ist ein temporäres OAuth2-Zugriffstoken, das vom Brightcove OAuth Dienst bezogen werden muss. Weitere Informationen zum Abrufen von Client-Anmeldeinformationen und zum Abrufen von Zugriffstoken finden Sie im Thema Brightcove OAuth Overview .

Betrieb

Wenn Sie Client-Anmeldeinformationen anfordern, müssen Sie die Art des Kontozugriffs oder die gewünschten Vorgänge angeben. Im Folgenden finden Sie eine Liste der derzeit unterstützten Vorgänge für Social API :

• video-cloud/social/status/read

Beachten Sie, dass die Social API zwar in der Beta-Phase vorhanden ist, die Berechtigungen dafür im Abschnitt Studio-Admin für die Verwaltung von API-Anmeldeinformationen nicht verfügbar sind. Stattdessen müssen Sie die OAuth API verwenden, um Ihre Anmeldeinformationen zu erstellen. Brightcove Learning Services hat dafür jedoch ein einfaches Online-Tool entwickelt.

Zusammenfassung der Anfragen

In der aktuellen Version der API werden nur GET Anfragen unterstützt. Es gibt zwei Gruppen von Anfragen, die in den folgenden Abschnitten zusammengefasst sind.

Status-Anfragen

Statusanfragen geben den aktuellen Social-Sharing-Status für Videos zurück. Sie können den Status für alle Videos in Ihrem Konto oder ein bestimmtes Video abrufen.

Verlaufswünsche

Verlaufsanfragen geben den Social-Sharing-Verlauf für Videos zurück. Sie können den Verlauf für alle Videos in Ihrem Konto oder ein bestimmtes Video abrufen.