Actions92
- Channel Actions
- Channel > Config Actions
- Event Actions
- Integrations Actions
- Live Actions
- Misc > Countries Actions
- Misc > Stream Actions
- Option Actions
- Option > Record Actions
- Option > Record > Instant Actions
- Option > Record > Storage Actions
- Option > Timeshift Actions
- Option > Watermarking Actions
- Option > Simulcast Actions
- Players Actions
- Players > Ads Actions
- Players > Embeds Actions
- Players > Pictures Actions
- Prices Actions
- Restrictions Actions
- Stats > Channel > Connection History Actions
- Stats > Channel > Consumption Actions
- Stats > Channel > Export Stats Actions
- Stats > Channel > Geolocation Actions
- Stats > Channel > Technologies Actions
- Stats > Channel > Viewers Actions
- Stats > Channel > Viewing Actions
- Stats > Globals > Consumption Actions
- Stats > Globals > Geolocation Actions
- Stats > Globals > Viewers Actions
- Stats > Globals > Viewing Actions
- Thumbnail Actions
- Order Actions
Players > Ads → Update An Ads
AI-generatedSummary
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