oEmbed Service

The oEmbed Service delivers a full media embed code from a URL.

The default output of the oEmbed Service is a JSON encoded string containing the embed code and information about the video (e.g. provider, author, size, thumbnail). Several options can be specified/overruled by issuing query string parameters of which the url query string parameter is compulsory. To obtain an XML response instead of the default JSON response, use the format query string parameter by setting this to format=xml. It’s also possible to change the width and height of the playout and the width and height of the thumbnail image.

The information about the resource provider in the oEmbed output will remain empty unless it is specified through the configuration fields in the publication’s portal.
To set up the provider name and provider url go to the configuration tab in your publication portal and create a field called “providerName” and a field called “providerUrl”.
If you’re not sure where to do this, please send a mail to support@bluebillywig.com asking us to set up the fields for you.

https://<publication>.bbvms.com/oembed/?url=https%3A//<publication>.bbvms.com/p/default/c/<clipId>.html&[Optional Parameters]

Required parametersDescription
urlThe url containing the clip id and playout (e.g. url=https://<publication>.bbvms.com/p/[playout}/c/[clip id].html)
Optional parameters
widthSet the width of the embed code
heightSet the height of the embed code
thumbWidthSet the width of the thumbnail
thumbHeightSet the height of the thumbnail
formatxml or json; Defaults to json

Was this article helpful?

Related Articles