Set a timed release

For relevant platforms supporting release time, it is possible to set a specific Release Time for products through a dedicated offer.

To do this, we will create a specific offer on a platform and enable UTC time, corresponding to a 'Global Timed Release' (option: release_time_global). We will also specify a release time in thehh:mm format (option: release_time)

In this case the product will be set at 10:00 UTC time, therefore released at 19:00 in Japan, 15:30 in India, 13:00 in Egypt, 12:00 in France, 07:00 in Argentina, etc.

response = RestClient.post(
             "https://api.idol.io/api/v2/offers",
             {
               "data": {
                 "attributes": {
                   "status": "active",
                   "release-date": "2025-01-01",
                   "options":[
                     {
                       "name":"release_time",
                       "value":"10:00"
                     },
                     {
                       "name":"release_time_global",
                       "value":true
                     }
                   ],
                   "is-default": false
                 },
                 "relationships": {
                   "product": {
                     "data": {
                       "type": "products",
                       "id": "214477"
                     }
                   },
                   "dsp-upload-identifications": {
                     "data": [{
                       "type": "dsp-upload-identifications",
                       "id": "374"
                       }]
                     }
                   },
                   "type": "offers"
                 }
               }.to_json,
             "Content-Type": 'application/vnd.api+json',
             "Authorization": "Bearer <token>"
            )

specific_offer_id = JSON.parse(response)['data']['id']
// => 377752