Ajouter un filtrage géo-filtrant

Dans cette rubrique, vous apprendrez comment gérer les propriétés de géo-restriction pour les vidéos à l'aide de l'API CMS. Le CMS API permet d'ajouter des propriétés de géo-filtrage aux vidéos afin de fournir une liste des pays dans lesquels ils peuvent (ou ne peuvent pas) être consultés.

Introduction

Les propriétés de filtrage géographique peuvent être ajoutées lorsque vous créez la vidéo à l'aide d'une requête POST ou lorsque vous utilisez une requête PATCH pour mettre à jour les métadonnées vidéo. Voir Mettre à jour les vidéos en utilisant CMS API pour un exemple de demande de mise à jour.

Au lieu ou en plus d'appliquer le géo-filtrage au niveau vidéo, vous pouvez appliquer le géo-filtrage aux lecteurs Brightcove via des clés de stratégie. Video Cloud examine à la fois les politiques de filtrage géo-filtrage au niveau de la vidéo et du lecteur, et appliquera les deux. Si un pays est exclu par l'une ou l'autre politique, la vidéo ne sera pas disponible dans le pays.

Notez que les codes pays doivent être saisis en minuscules.

Certains éditeurs ont demandé la possibilité de filtrer les vidéos vers les bases militaires américaines ainsi qu'aux États-Unis. Pour soutenir cela, il existe une option militaire américaine . Bien qu'il n'existe pas de moyen fiable à 100 % d'identifier une base militaire, lorsqu'une adresse IP qui se résoudra à un domaine .mil est rencontrée et n'est pas aux États-Unis, elle sera identifiée comme provenant d'une base militaire américaine plutôt que de son pays d'origine réel. Les adresses .mil qui se trouvent aux États-Unis seront toujours identifiées comme « nous&quot ;.

Accès au géo-filtrage

Autorisation

Les opérations dont vous aurez besoin d'autorisations pour mettre à jour les métadonnées vidéo sont video-cloud/video/update ou video-cloud/video/all.

Syntaxe

geo est un objet avec trois propriétés :

Propriété	Type	Obligatoire	Commentaires
`geo.countries`	Tableau de chaînes de code pays	non	Une liste ISO 3166 de codes à 2 lettres en minuscules pour les pays qui seront mis en liste blanche ou en liste noire pour visionner la vidéo
`geo.exclude_countries`	Booléen	non	Si `true`, l'affichage n'est pas autorisé dans les pays inclus dans la `geo.countries` liste ; si `false`, l'affichage est uniquement autorisé dans ces pays.
`geo.restricted`	Booléen	non	Si le filtrage `true` géo-filtrage est activé pour la vidéo

Requête

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

Corps de la demande :

Le corps de requête sera un objet JSON contenant un tableau d'abréviations de pays à inclure ou à exclure :

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