Geo-Filter hinzufügen

In diesem Thema erfahren Sie, wie Sie Geo-Restriction-Eigenschaften für Videos mithilfe des CMS APIdem „Vermischten Geschmack“. Seine CMS API Mit dieser Option können Sie Geo-Filter-Eigenschaften zu Videos hinzufügen, um eine Liste der Länder anzuzeigen, in denen sie angezeigt werden können (oder nicht).

Einführung

Geo-Filter-Eigenschaften können hinzugefügt werden, wenn Sie das Video zunächst mit einer POST-Anforderung erstellen oder eine PATCH-Anforderung zum Aktualisieren der Videometadaten verwenden. Sehen Aktualisieren Sie Videos mit CMS API für ein Beispiel einer Aktualisierungsanforderung.

Statt oder zusätzlich zur Geo-Filterung auf Videoebene können Sie Wenden Sie die Geofilterung auf Brightcove an players über Richtlinienschlüssel. Video Cloud schaut sich sowohl Video als auch an player Geofilterungsrichtlinien auf Ebene und werden beide anwenden. Wenn ein Land von einer der beiden Richtlinien ausgeschlossen ist, ist das Video im Land nicht verfügbar.

Beachten Sie, dass Ländercodes eingegeben werden sollten Kleinbuchstaben.

Einige Verlage haben um die Möglichkeit gebeten, Videos an US-amerikanische Militärstützpunkte und die USA zu filtern. Um dies zu unterstützen, gibt es ein U.S. Militär Möglichkeit. Zwar gibt es keine zuverlässige 100% -Methode, um eine Militärbasis zu identifizieren. Wenn jedoch eine IP-Adresse in einer .mil-Domäne gefunden wird und nicht in den USA, wird sie als von einer US-Militärbasis kommend identifiziert Herkunfts. .mil-Adressen in den USA werden weiterhin als "uns" gekennzeichnet.

Zugriff auf Geo-Filterung

Genehmigung

Die Vorgänge, für die Sie Berechtigungen benötigen, um Video-Metadaten zu aktualisieren, sind video-cloud/video/update or video-cloud/video/all.

Syntax

geo ist ein Objekt mit drei Eigenschaften:

Immobilien	Typ	Erforderlich	Kommentare
`geo.countries`	Array der Ländercodes Strings	nicht	An ISO 3166-Liste von 2-Buchstabencodes in Kleinbuchstaben für Länder, die auf die weiße Liste gesetzt oder auf die schwarze Liste gesetzt werden, um das Video anzusehen
`geo.exclude_countries`	Boolean	nicht	If `true`Sehen ist nicht erlaubt in Ländern, die in der `geo.countries` Liste; ob `false`Sehen ist ausschließlich in diesen Ländern erlaubt.
`geo.restricted`	Boolean	nicht	If `true` Geo-Filterung ist für Video aktiviert

Ihre Anfrage

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

Anfrage Körper:

Der Anfragetext wird ein JSON-Objekt sein, das ein Array von Länderabkürzungen enthält, die ein- oder ausgeschlossen werden sollen:

    {"geo" : {
        "restricted" : true,
        "exclude_countries" : false,
        "countries" : ["ph","in","my","ja"]
      }
    }