Difference between revisions of "CancelRecordingSchedule"

From Gvp-public
Jump to navigation Jump to search
Line 42: Line 42:
 
|ParamType=bool
 
|ParamType=bool
 
|ParamRequired=optional (default=false)
 
|ParamRequired=optional (default=false)
|ParamDescription=If the Schedule Id is a series episode, all the next episodes should also be scheduled for recording when set to true. If set to false, only the single episode will be scheduled.
+
|ParamDescription=Whether cancel operation affects a whole series scheduling or not
 
}}
 
}}
 
{{Api_Parameter|
 
{{Api_Parameter|

Revision as of 08:12, 31 October 2014

Description

Cancel each of the given RecordingSchedule and delete them from the platform.

Returns an rray of RecordingSchedule objects, filled with the recording related parameters:

  • If the recording schedule was successfully cancelled and deleted by the platform, its state will be "Canceled"
  • If a given recording schedule could not be canceled, its state will remain "Scheduled".
  • If a given recording schedule 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 cancelled (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 cancel 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 canceled


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