Mettre à jour en masse les heures d'ouverture

La clé pour mettre à jour les heures d'ouverture en masse est le paramètre minute_mask. Dans cette section, nous décrivons comment calculer les valeurs de la chaîne minute_mask.

Vous devez encoder le champ en minutes par semaine. Chaque plage représente un bloc de temps contigu, représentant chaque période d'heure d'ouverture.

Comptez chaque minute d'une semaine de 0 à 10079.

Gardez à l’esprit les points suivants :

• La minute 0 commence à 00h00 le lundi
• Il y a 1440 minutes par jour, 10080 minutes par semaine.
• La dernière minute adressable dans une semaine est 10079. Elle représente la minute de 23:59:00 à 24:00:00 le dimanche d'une semaine donnée.
• La fin d'une plage de minutes inclut la dernière minute qu'elle décrit. Par exemple, pour terminer à 17 heures précises :
• La saisie de 1019 est correcte car elle inclut la minute de 16:59:00 à 17:00:00.
• La saisie de 1020 est incorrecte car elle inclut la minute de 17:00:00 à 17:01:00. Par conséquent, vous devrez soustraire 1 minute de la fin d’une plage pour être précis.
• Vous devez séparer chaque plage par un point-virgule.

Pour représenter les heures d'ouverture de 9 h à 17 h tous les jours de la semaine, le minute_mask serait :

Nous avons calculé l'encodage de cette manière :

9 AM on Monday = 9 * 60 minutes = 540
5 PM on Monday = (9 * 60 minutes) + [(8 * 60 mins) - 1] = 1019
9 AM on Tuesday = 33 * 60 mins = 1980
5 PM on Tuesday = (33 * 60 mins) + [(8 * 60 mins) - 1] = 2459
9 AM on Wednesday = (57 * 60 mins) = 3420
5 PM on Wednesday = (57 * 60 mins) + [(8 * 60 mins) - 1] = 3899

Vous devez saisir la chaîne dans le paramètre minute_mask en utilisant le format suivant :

540-1019;1980-2459;3420-3899;4860-5339;6300-6779;7740-8219;9180-9659

Dans notre exemple de requête, nous utiliserons l'ID# de la partie du jour ( id ) que nous avons créée dans Ajouter des unités d'affichage : Étape 2 - Ajouter une partie du jour.

Note : Les numéros d'identification que nous utilisons dans ces échantillons sont fournis à titre d'illustration. Ils ne sont pas valides. Assurez-vous d’utiliser vos propres numéros d’identification pour vos intégrations. De plus, dans nos exemples, nous utilisons le point de terminaison api-sandbox et le jeton HTTP.

curl -X PUT \
    https://api-sandbox.broadsign.com:10889/rest/day_part/v5 \
    -H 'authorization: Bearer 3b24e003152ffcd240f0260d1df77ba6' \
    -H 'cache-control: no-cache' \
    -H 'content-type: application/json' \
    -d '{
    "id": 3233,
    "day_mask": 127,
    "domain_id": 123456789,
    "start_date": "2017-10-31",
    "end_date": "2018-10-31",
    "start_time": "00:00:00",
    "end_time": "23:59:59",
    "impressions_per_hour": -1,
    "minute_mask": "0-59;1440-1499;2880-2939;4320-4379;5760-5819;7200-7259;8640-8699",
    "name": "day_part_modified_using_rest_api",
    "virtual_start_date": "1756-01-01",
    "virtual_end_date": "8000-12-31",
    "weight": 2,
    "active": true
    }'

{
        "day_part": [
        {
            "id": 3233
         }
       ]
    }