Difference between revisions of "DeleteRecordingSchedule"

From Gvp-public
Jump to navigation Jump to search
Line 27: Line 27:
 
}}
 
}}
 
{{Api_Parameter|
 
{{Api_Parameter|
ParamName=channelId
+
ParamName=EPGLiveChannelReferenceId
 
|ParamType=int
 
|ParamType=int
 
|ParamRequired=required
 
|ParamRequired=required
|ParamDescription=Live Channel ID
+
|ParamDescription=Live Channel ID (as appearing in EPG file)
 
}}
 
}}
 
{{Api_Parameter|
 
{{Api_Parameter|
Line 60: Line 60:
  
 
|Exceptions=
 
|Exceptions=
* [[StatusCode#AuthenticationRequiredException|AuthenticationRequiredException]]: if authentication parameters are incorrect/missing.
+
* None.
* [[StatusCode#MissingRequiredParameter|MissingRequiredParameter]]: if a required parameter is missing.
 
* [[StatusCode#InvalidLiveProgramException|InvalidLiveProgramException]]: if the program id is invalid.
 
* [[StatusCode#UnexpectedRecordingResponseException|UnexpectedRecordingResponseException]]: General recording service exception.
 
  
 
|Cache=
 
|Cache=

Revision as of 06:53, 19 September 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.
  • recordingScheduleId (int, required)
ID of the Recording Schedule to be canceled
  • programId (int, required)
Live Program ID
  • EPGLiveChannelReferenceId (int, required)
Live Channel ID (as appearing in EPG file)
  • serieId (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))
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.


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