vidinfra
  1. Advertisements
vidinfra
  • Documentation
    • Guides
      • Welcome
      • Getting Started
        • What is Vidinfra?
        • Quick Start Guide
        • Publish First Video
        • FAQs
      • Upload & Import Videos
        • Upload from Device
        • Import from Vimeo
        • Import from YouTube
        • Import from Zoom
      • DRM
        • Widevine DRM
        • FairPlay DRM
      • Accounts
        • Accounts
      • Organization Settings
        • User Management
        • Billing
        • Settings
  • API Reference
    • Projects
      • Get projects list
      • Get project
      • Create New Project
      • Destory Project
      • Update project
      • upload logo
      • Get Project Settings
      • Upsert Project Settings
    • importer.vidinfra.com
      • welcome
      • Debug
      • test
    • Auth
      • User Registration
      • User Login
      • Verify-email
      • Forgot Password
      • Forgot Password Verify OTP
      • Forgot Password Set
      • Resend OTP
      • Logout
      • Set Password
      • Check Account exists
      • Update Password
      • Google Oauth Redirect
      • Google Oauth Callback
      • api-access-check
      • New Auth token using Refresh token
      • Github Oauth Redirect
      • Google Oauth Callback Copy
      • Get User Sessions
      • Delete User Sessions
    • User
      • Profiles
      • Profile Updates
      • Profile Avatar update
    • Organization
      • List organizations
      • Create an organization
      • Get an organization
      • Update an organization
      • Switch an organization
    • Organization's invitations
      • Sent invitation list
      • Send invitation
      • Show Token
      • Accept Invitation
      • Reject Invitation
    • Audits
      • Audits
    • Members
      • Members
      • test permission
    • API Keys
      • Get All API keys
      • Get API Key
      • Create API Keys
      • Destory API Keys
      • api key middleware (test)
    • Folders
      • Get All Folders
      • Create Folder
      • Get Folder by ID
      • Update Folder
      • Move Folder
      • Bulk Move Folders (empty)
      • Delete Folder
      • Get Folder Tree
    • Videos
      • Get All video of a project
      • Get a Video
      • Get Video using Custom field
      • create video
      • Upload thumbnail
      • Update video
      • Destroy video
      • Search Video
      • batch video Assign to collecition
      • Mark Thumbnail As Default
      • Get Video Timelines
    • Video Metas
      • Create or Update Video Meta Data
      • Get All Meta Data of a Video
    • Video Captions
      • create video caption
      • Delete a video Caption
      • Get video caption
    • Video Chapter
      • create video chapters
    • Uploads
    • Tags
      • Get all tags upder a project
      • Create Tag
      • Delete tag
    • Players
      • Get all Players
      • Create Player
      • Get Specific player
      • update player
      • Delete Player
      • Player Mark as default
    • Webhook Endpoints
      • Get webhook
      • create web hook
      • GET Webhook by ID
      • Update webhook
      • Delete web hook
    • Advertisements
      • get all ads
        GET
      • create ads
        POST
      • get single advertisement
        GET
      • Update ads
        PUT
      • Delete ads
        DELETE
    • Webhook Event Logs
      • Get webhook event logs
      • Resend Webhook event by Id
      • Resend All Webhook Event
    • Analytics Direct Api
      • geo-distribution
      • Project Views
      • avg video watch
      • Total watch Time
      • Project Avg Watch per Unique user
      • Total Player Error
      • project popularity-analysis
      • Project Collection Insights
      • Collection Views
      • Collection avg Watch time
      • Collection Avg Watch per unique user
      • Collection Geo Distribution
      • Get all Users
      • User media views
      • User Avg video watch
      • user Player log
      • user sessions
      • Get all Video
      • video Player error
      • Video View
      • video Geo Distribution
      • video Avg watch
      • copy
    • Streams
      • Create livestream
      • Get all stream
      • Get a livestream
      • update status of livestream
      • delete a stream
      • get livestream historys
    • Stream Metas
    • Usages
      • Bandwidth Usage
      • Storage Usage
      • Get Over Usage
    • Encoding profile
      • Get all profiles
      • Create profile
      • Get A profile
      • Update a encoding profile
      • Delete a encoding profile
      • Make a profile default
    • Project Matrics
      • Get Matrics
      • project Usages
    • Access Control
      • Put Access Control
      • Get access Control
    • Analytics
      • Project Get geo-distribution
      • project views
      • Project avg video watch
      • Project Total Watch
      • Project Avg Watch per Unique user
      • Project All Player Errors
      • Project Popularity Analysis
      • Project Collections insights
      • Collection Geo Distribution
      • Collection avg watch time
      • Collection avg watch per unique User
      • Collection Player error
      • Video Geo Distribution
      • Video views
      • Video Avg Watch
      • Video Player Log
      • User
      • User Avg Video Watch
      • User Total Watch
      • User player error log
    • Plan
      • public plans
      • current plan
      • Account Plans
      • Get plan by ID
      • Admin Get Plans
      • Admin Create plan
      • Admin Get Plan by ID
      • Admin Update Plan by ID
      • Admin Delete plan By ID
      • Admin Get Plan Metrices
      • Admin Get Plan Metrices By Type
      • Admin Create Plan Matrices By Type
      • Admin Update Plan Metrices By ID
    • Upload Tokens
      • Obtain credentials before upload
    • subscribe
      • stripe redirect subscription
        • create checkout session
        • over usage payment
      • current subscription
      • discribe a plan by planCode
      • subscribe
      • cancel subscription
      • over usage payment
      • Stripe over usage autopay payment (test)
    • Transaction
      • Get All Transaction
    • Invoice
      • Get All Invoices
      • Get Invoice by ID
    • vimeo video importer
      • vimeo job list
      • Vimeo videos by migration id
      • Vimeo Set video importer
      • Vimeo sync import
      • Vimeo import videos
      • Get pull videos
      • pull video from url
    • test
      • Welcome to vidinfra Copy
      • metrics
    • transcoding service
      • get all jobs
      • get a job
      • create jobs
      • Update a job
      • Delete a job
      • create job v2
    • transcoding service v2
      • create jobs
      • get all jobs
      • get a job
      • Update a job
      • Delete a job
    • Welcome to vidinfra
      GET
    • health check
      GET
    • Regions List
      GET
    • key
      POST
    • Untitled Endpoint
      GET
  1. Advertisements

Update ads

Developing
PUT
/projects/{projId}/advertisements/{advertisementId}

Update a Advertisements for a project#

📣 this endpoint update a Advertisement under a project . In this PUT request the project ID and Advertise ID has to be provided . All the necessary data has to be provided in the request payload
✳ list of URL parameters
project_id = 36 character in length
advertisement_id = 36 character in length
📢 Info message : Here URL is contructed like
PUT /projects/<project_id>/advertisements/<advertisement_id>

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
projId
string 
required
Example:
f32a0116-fe11-454c-8e6a-5ff4101882e5
advertisementId
string 
required
Example:
800edeb9-b8e0-4ae2-9902-712c65a0edee
Body Params application/json
object {0}
Example
{
    "name": "Sample Advertisement new",
    "folder_id": "e6095ec4-ee31-4b18-aa6c-fc4ee5d59321",
    "tag_url": "http://example.com/tag",
    "active": true,
    "default": false 
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'http://localhost:8080/v1/projects/f32a0116-fe11-454c-8e6a-5ff4101882e5/advertisements/800edeb9-b8e0-4ae2-9902-712c65a0edee' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Sample Advertisement new",
    "folder_id": "e6095ec4-ee31-4b18-aa6c-fc4ee5d59321",
    "tag_url": "http://example.com/tag",
    "active": true,
    "default": false 
}'

Responses

🟢200OK
application/json
Body
object {0}
Example
{"message":"Advertisement updated successfully.","result":{"id":"07df2817-116f-47b7-9da7-67005ef83a20","user_id":"10bb71cf-57e0-436d-a449-0b68ef13c731","project_id":"5eca71a3-bc93-45cf-ad6e-45be2961f921","collection_id":"00000000-0000-0000-0000-000000000000","tag_url":"http://example.com/tag","name":"Sample Advertisement new","active":true,"default":false,"created_at":"2024-02-06T14:11:10+06:00","updated_at":"2024-02-06T09:09:49.602629289Z","created_by":"10bb71cf-57e0-436d-a449-0b68ef13c731","updated_by":"10bb71cf-57e0-436d-a449-0b68ef13c731"},"success":true}
🟢200OK
🟢200OK final 1
Previous
get single advertisement
Next
Delete ads
Built with