Geo-Filterung hinzufügen

In diesem Thema erfahren Sie, wie Sie Geo-Restriktionseigenschaften für Videos mithilfe der CMS-API verwalten. CMS API Mit der können Sie Videos Geo-Filter-Eigenschaften hinzufügen, um eine Liste der Länder bereitzustellen, in denen sie angezeigt werden können (oder nicht).

Einführung

Geo-Filtering-Eigenschaften können hinzugefügt werden, wenn Sie das Video zum ersten Mal mit einer POST-Anfrage oder mit einer PATCH-Anfrage zur Aktualisierung der Video-Metadaten erstellen. Siehe Videos aktualisieren CMS APIfür ein Beispiel für eine Aktualisierungsanfrage.

Anstatt oder zusätzlich Geo-Filterung auf Videoebene anzuwenden, können Sie die Geo-Filterung über Richtlinienschlüssel auf Brightcove-Spieler anwenden. Video Cloud betrachtet sowohl die Geo-Filter-Richtlinien auf Video- als auch auf Player-Ebene und wird beides anwenden. Wenn ein Land von einer der Richtlinien ausgeschlossen wird, ist das Video im Land nicht verfügbar.

Beachten Sie, dass Ländercodes in Kleinbuchstabeneingegeben werden sollten.

Einige Verlage haben die Möglichkeit gefordert, Videos sowohl auf US-Militärbasen als auch in die USA zu filtern. Um dies zu unterstützen, gibt es eine Option für das US-Militär . Obwohl es keinen 100% zuverlässigen Weg gibt, eine Militärbasis zu identifizieren, wird eine IP, die sich in eine MIL-Domäne löst, angetroffen wird und nicht in den USA ist, sie wird als von einer US-Militärbasis und nicht von ihrem tatsächlichen Herkunftsland stammend identifiziert. .mil-Adressen, die sich in den USA befinden, werden immer noch als „uns“ bezeichnet.

Zugang zu Geo-Filterung

Autorisierung

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

Syntax

geo ist ein Objekt mit drei Eigenschaften:

Eigenschaft	Art	Erforderlich	Kommentare
`geo.countries`	Array von Ländercode Strings	Nein	Eine ISO 3166-Liste von 2-Buchstaben-Codes in Kleinbuchstaben für Länder, die zum Ansehen des Videos auf die Whitelist gesetzt oder auf die schwarze Liste gesetzt werden
`geo.exclude_countries`	Boolesch	Nein	Wenn `true` Betrachtung ist nicht erlaubt in Ländern in der `geo.countries` Liste; wenn `false` Betrachtung ist nur in diesen Ländern erlaubt.
`geo.restricted`	Boolesch	Nein	Wenn die `true` Geo-Filterung für Video aktiviert ist

Anforderung

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

Anfrage Body:

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

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