Ajouter des unités d'affichage

Ce cas d'utilisation décrit les exigences pour ajouter des unités d'affichage à votre domaine à l'aide de Broadsign Control API via REST.

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.

Une unité d'affichage de base comporte quelques composants différents : une « coque » d'unité d'affichage, une partie de la journée, un cadre et un critère.

Pour ajouter des unités d’affichage, utilisez les méthodes suivantes :

  • Ajoutez une unité d'affichage en utilisant POST et la méthode /display_unit/v12/add.
  • Ajoutez une partie de la journée à l'unité d'affichage, en utilisant POST et la méthode /day_part/v5/add.
  • Ajoutez un cadre à la partie de la journée, en utilisant POST et la méthode /skin/v7/add.
  • Ajoutez un critère à l'unité d'affichage, en utilisant POST et la méthode /resource_criteria/v7/add.

Cette étape ajoute une nouvelle unité d’affichage à votre domaine.

Copier 

    curl -X POST \
    https://api-sandbox.broadsign.com:10889/rest/display_unit/v12/add \
    -H 'authorization: Bearer YourAPIKeyHere' \
    -H 'cache-control: no-cache' \
    -H 'content-type: application/json' \
    -d '{
    "display_unit_type_id": 567,
    "enforce_day_parts": true,
    "name": "cURL Display Unit",
    "container_id": 9999,
    "domain_id": 123456789
}'
Copier 
{
    "display_unit": [
    {
        "id": 3232
    }
    ]
}

Ensuite, vous utiliserez le numéro d’identification de votre nouvelle unité d’affichage pour ajouter une partie de la journée.

Cette étape ajoute une partie de la journée à votre nouvelle unité d’affichage. Utilisez la réponse de Étape 1 : Ajouter une unité d’affichage dans le paramètre de demande parent_id.

Copier 
curl -X POST \
    https://api-sandbox.broadsign.com:10889/rest/day_part/v5/add \
    -H 'authorization: Bearer YourAPIKeyHere' \
    -H 'cache-control: no-cache' \
    -H 'content-type: application/json' \
    -d '{
    "name": "24/7",
    "day_mask": 127,
    "parent_id": 3232,
    "start_date": "",
    "end_date": "",
    "start_time": "00:00:00",
    "end_time": "00:00:00",
    "virtual_start_date": "1756-01-01",
    "virtual_end_date": "8000-12-31",
    "impressions_per_hour": -1,
    "weight": 0,
    "domain_id": 123456789
    }'
Copier 
{
    "day_part": [
    {
        "id": 3233
    }
    ]
}

Ensuite, nous allons ajouter un cadre à notre nouvelle partie de la journée (et, par extension, à notre nouvelle unité d'affichage).

Cette étape ajoute un cadre à votre nouvelle partie de la journée (et, par extension, à votre nouvelle unité d'affichage). Utilisez la réponse de Étape 2 : Ajouter une partie de la journée dans le paramètre de demande parent_id.

Copier 
curl -X POST \
    https://api-sandbox.broadsign.com:10889/rest/skin/v7/add \
    -H 'authorization: Bearer YourAPIKeyHere' \
    -H 'cache-control: no-cache' \
    -H 'content-type: application/json' \
    -d '{
    "parent_id": 3233,
    "geometry_type": 1,
    "height": 100,
    "width": 100,
    "x": 0,
    "y": 0,
    "name": "Fullscreen cURL",
    "loop_policy_id": 357,
    "screen_no": 1,
    "domain_id": 123456789
    }'
Copier 
{
    "skin": [
    {
        "id": 3236
    }
    ]
}

Enfin, vous ajouterez un critère à votre unité d’affichage pour un ciblage précis.

Cette dernière étape ajoute un critère à votre nouvelle unité d’affichage. Utilisez la réponse de Étape 1 : Ajouter une unité d’affichage dans le paramètre de demande parent_id. Pour le paramètre criteria_id, utilisez l'ID unique d'un critère existant sur votre domaine.

Copier 
curl -X POST \
    https://api-sandbox.broadsign.com:10889/rest/resource_criteria/v7/add \
    -H 'authorization: Bearer YourAPIKeyHere' \
    -H 'cache-control: no-cache' \
    -H 'content-type: application/json' \
    -d '{
    "parent_id": 3232,
    "criteria_id": 555,
    "domain_id": 123456789
    }'
Copier 
{
    "resource_criteria": [
    {
        "id": 808080
    }
    ]
}