Infomaniak Streaming Video icon

Infomaniak Streaming Video

Interact with Infomaniak Streaming Video API

Actions92

Players > Ads → Update An Ads

AI-generated

Summary

Update an existing Infomaniak Streaming Video ad identified by channel, player, and ad IDs.

Inputs

  • authentication — Authentication method; either OAuth2 or API Key.
  • path_channel (required) — Unique identifier of the channel containing the ad.
  • path_player (required) — Unique identifier of the player associated with the ad.
  • path_ads (required) — Unique identifier of the ad to update.
  • query_account_id (required) — Account identifier for the request.
  • queryParameters — Additional query parameters; can include 'query_with' to retrieve extra resource data.
  • bodyParameters — Body fields for the update; includes 'body_is_periodic' (boolean), 'body_offset' (number), 'body_type' (pre-roll or mid-roll), and 'body_url' (XML URL).
  • returnFullResponse — When true, the full response body is returned; otherwise only a success/failure indicator is provided.

Output shape

a single updated ad record

Returns the updated ad when returnFullResponse is true; otherwise only a success indicator. May include error envelope or pagination information.

Examples

Example 1: Update a mid‑roll ad in a specific channel

authentication=oauth2, path_channel=12, path_player=5, path_ads=3, body_is_periodic=true, body_type=mid-roll, body_offset=0, returnFullResponse=true

Example 2: Update an ad using API Key with minimal required IDs

authentication=apiKey, path_channel=7, path_player=2, path_ads=1, query_account_id=456

Example 3: Update an ad and request additional related data

authentication=oauth2, path_channel=3, path_player=9, path_ads=2, queryParameters.query_with=related, body_is_periodic=false, body_offset=10, body_type=pre-roll, returnFullResponse=false

Links

Discussion