action britbox_get_item_media_files_guarded { label: "getItemMediaFilesGuarded" description: "Get the video files associated with an item given maximum resolution, device type\nand one or more delivery types.\n\nThis endpoint is identical to the `/account/items/{id}/videos` however it expects\nan Account Playback token. This token, and in association this endpoint, is specifically\nfor use when playback files are classification restricted and require an account\nlevel pin to access them.\n\nReturns an array of video file objects which each include a url to a video.\n\nThe first entry in the array contains what is predicted to be the best match.\nThe remainder of the entries, if any, may contain resolutions below what was\nrequests. For example if you request HD-720 the response may also contain\nSD entries.\n\nIf you specify multiple delivery types, then the response array will insert\ntypes in the order you specify them in the query. For example `stream,progressive`\nwould return an array with 0 or more stream files followed by 0 or more progressive files.\n\nIf no files are found a 404 is returned.\n" provider: britbox method: GET path: "/account/items/{id}/videos-guarded" encoding: json input: { type: "object" properties: { id: { type: "string" } } required: ["id"] additionalProperties: false } output: { type: "array" items: { type: "object" required: ["name", "deliveryType", "url", "drm", "format", "resolution", "width", "height", "language"] properties: { channels: { type: "integer" format: "int32" description: "The number of audio channels." } deliveryType: { type: "string" description: "The way in which the media file is delivered." enum: ["Stream", "Progressive", "Download"] } drm: { type: "string" description: "The type of drm used to encrypt the media. 'None' if unencrypted." } format: { type: "string" description: "The format the media was encoded in." } height: { type: "integer" format: "int32" description: "The height of the video media." } language: { type: "string" description: "The language code for the media, e.g. 'en'." } name: { type: "string" description: "The name of the media file." } resolution: { type: "string" description: "The resolution of the video media." enum: ["SD", "HD-720", "HD-1080", "HD-4K", "External", "Unknown"] } url: { type: "string" format: "uri" description: "The url to access the media file." } width: { type: "integer" format: "int32" description: "The width of the video media." } } additionalProperties: false } } }