Ajouter un géo-filtrage

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

Introduction

Les propriétés de géofiltrage peuvent être ajoutées lorsque vous créez initialement la vidéo à l'aide d'une requête POST ou en utilisant 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éofiltrage au niveau de la vidéo, vous pouvez appliquer le filtrage géographique à Brightcove players via les clés de stratégie. Video Cloud regarde à la fois la vidéo et player niveau de géo-filtrage 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 minuscule.

Certains éditeurs ont demandé la possibilité de filtrer géographiquement les vidéos des bases militaires américaines ainsi que des États-Unis. Pour soutenir cela, il y a un Armée américaine option. Bien qu'il n'y ait pas de moyen 100% fiable pour identifier une base militaire, quand une adresse IP qui résout 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 réel d'origine. Les adresses .mil qui se trouvent aux États-Unis seront toujours identifiées comme "nous".

Accès au géo-filtrage

Autorisation

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

Syntaxe

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

Propriété	Type	Requis	Commentaires
`geo.countries`	Tableau des chaînes de code de pays	aucune	An Liste ISO 3166 des codes 2-lettre en minuscule pour les pays qui seront sur liste blanche ou sur liste noire pour visionner la vidéo
`geo.exclude_countries`	Boolean	aucune	If `true`, la visualisation est ne sont pas autorisés dans les pays inclus dans `geo.countries` liste; si `false`, la visualisation est uniquement. autorisés dans ces pays.
`geo.restricted`	Boolean	aucune	If `true` le géofiltrage est activé pour la vidéo

Demande

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

Demander le corps:

Le corps de la demande 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"]
      }
    }