Modifier/reprogrammer une campagne

Ce cas d'utilisation décrit les exigences pour modifier ou reprogrammer une campagne sur 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.

Pour modifier ou reprogrammer une campagne, utilisez les méthodes suivantes :

  • Mettre à jour/modifier une campagne/réservation existante à l'aide de PUT et de la méthode /reservation/v20.
  • Ré-réserver une campagne/réservation existante en utilisant POST et la méthode /reservation/v20/rebook.
  • Confirmez la campagne/réservation reprogrammée en utilisant POST et la méthode /reservation/v20/rebook_confirm.

Pour mettre à jour une campagne/réservation existante sur votre domaine, vous aurez besoin de son identifiant unique et de son nom.

Copier 
curl -X PUT \
    https://api-sandbox.broadsign.com:10889/rest/reservation/v21 \
    -H 'authorization: Bearer YourAPIKeyHere' \
    -H 'cache-control: no-cache' \
    -H 'content-type: application/json' \
    -d '{
    "domain_id": 123456789,
    "id": 12345,
    "name": "cURL Clone Renamed via RestAPI (TM)",
    "state": 1,
    "container_id": 1776
    }'
Copier 
{
    "reservation": [
    {
    "id": 12345
    }
    ]
}

Pour réserver à nouveau une campagne/réservation existante, vous aurez besoin de son numéro d'identification unique. Notez que votre campagne reprogrammée aura un nouveau numéro d'identification.

La modification d'une campagne/réservation se fait en deux étapes : la modification de la réservation et la confirmation.

Copier 
curl -X POST \
    https://api-sandbox.broadsign.com:10889/rest/reservation/v21/rebook \
    -H 'authorization: Bearer YourAPIKeyHere' \
    -H 'cache-control: no-cache' \
    -H 'content-type: application/json' \
    -d '{
    "domain_id": 123456789,
    "duration_msec": 45000,
    "end_date": "2018-12-12",
    "end_time": "22:00:59",
    "start_date": "2017-10-28",
    "start_time": "00:00:00",
    "id": 12345
    }'
Copier 
{
    "reservation": [
    {
    "id": 3232
}

Utilisez la réponse de votre demande de nouvelle réservation dans le paramètre de demande slot_transaction_id.

Copier 
curl -X POST \
    https://api-sandbox.broadsign.com:10889/rest/reservation/v21/rebook_confirm \
    -H 'authorization: Bearer YourAPIKeyHere' \
    -H 'cache-control: no-cache' \
    -H 'content-type: application/json' \
    -d '{
    "domain_id": 123456789,
    "id": 12345,
    "slot_transaction_id": 3232
    }'
Copier 
{
    "reservation": [
    {
    "id": 3232
    }
    ]
}