Difference between revisions of "DeleteRecordingSchedule"
Jump to navigation
Jump to search
Line 15: | Line 15: | ||
}} | }} | ||
{{Api_Parameter| | {{Api_Parameter| | ||
− | ParamName= | + | ParamName=scheduleId |
|ParamType=int | |ParamType=int | ||
|ParamRequired=required | |ParamRequired=required | ||
− | |ParamDescription= | + | |ParamDescription=schedule Id to be deleted (introduced -and kept for compatability in MiViewTV Phase I; superseded by recordingScheduleId) |
}} | }} | ||
{{Api_Parameter| | {{Api_Parameter| | ||
Line 30: | Line 30: | ||
|ParamType=int | |ParamType=int | ||
|ParamRequired=required | |ParamRequired=required | ||
− | |ParamDescription=Live Channel ID ( | + | |ParamDescription=Live Channel ID (EPGLiveChannelReferenceId; as appearing in EPG file) |
}} | }} | ||
{{Api_Parameter| | {{Api_Parameter| | ||
Line 42: | Line 42: | ||
|ParamType=bool | |ParamType=bool | ||
|ParamRequired=optional (default=false) | |ParamRequired=optional (default=false) | ||
− | |ParamDescription= | + | |ParamDescription=Whether delete operation affects a whole series scheduling or not |
+ | }} | ||
+ | {{Api_Parameter| | ||
+ | ParamName=recordingScheduleId | ||
+ | |ParamType=string | ||
+ | |ParamRequired=optional (declared "optional" for backwards compatibility; but needed for correct operation) | ||
+ | |ParamDescription=ID (string) of the Recording Schedule to be deleted | ||
}} | }} | ||
Revision as of 08:12, 31 October 2014
Description
Delete each of the given Schedule Recording from the platform. If the external platform provides a Network PVR service, this method will remove contents accessible by the network. In the case of Remote PVR service availability, this method will physically delete contents from the connected STB hard disk.
Returns an array of RecordingSchedule objects, filled with the recording related parameters:
- If the recording was successfully deleted by the platform, its state will be "Deleted"
- If a given recording could not be deleted, its state will remain "Recorded".
- If a given recording was not found, its state will be "Not Found".
Parameters
- token (String, required)
- A valid token for identifying the API session context and logged user.
- scheduleId (int, required)
- schedule Id to be deleted (introduced -and kept for compatability in MiViewTV Phase I; superseded by recordingScheduleId)
- programId (int, required)
- Live Program ID
- channelId (int, required)
- Live Channel ID (EPGLiveChannelReferenceId; as appearing in EPG file)
- seriesId (int, optional)
- ID of the series associated to the schedule. Value will be set to 0 if the program is not a series episode.
- entireSeries (bool, optional (default=false))
- Whether delete operation affects a whole series scheduling or not
- recordingScheduleId (string, optional (declared "optional" for backwards compatibility; but needed for correct operation))
- ID (string) of the Recording Schedule to be deleted
Returns
Returns a JSON object with a list of RecordingSchedule.
Example:
{
- "Offset": 0,
- "Limit": 10,
- "Count": 48,
- [ Array of RecordingSchedule objects ]
}
Exceptions
- None.
Caching
This method is not cached.
Known issues
None
Version history
API Version Number | Change description | Changes author |
---|---|---|
2.4 | Initial method design |
See also
- RecordingSchedule object type
- Network_Pvr_Service methods