GetProgramInfos
Description
Retrieves extended EPG data for one or more programs, specified by their program IDs. This method enables the client to retrieve EPG data for programs for which EPG data is not otherwise available. For example, the client can use this function to get EPG data for a completed recording that is stored on a set-top box (with its EPG data) but no longer appears in the current program guide.
The expected result is: IRemotePvrProgramInfosResult containing information about all the specified programs. If any of the transactions fails, the failures are noted in the returned object's FailedTransactions field, which contains one DVRTransactionReport (p. 329) for each failed operation. Each DVRTransactionReport contains the program ID whose information could not be retrieved (in the ItemId field) and a brief text description of the failure (in the ErrMsg field). Possible error messages include: • "Invalid id type": A member of programIds is not of type ProviderExternalId. • "Id not found ": The web service is unable to find program information for the specified program.
Parameters
- token (String, required)
- A valid token for identifying the API session context. The token can be anonymous or logged.
- programIds (RemotePvrProviderExternalId, required)
Returns
Returns a JSON object containing an ???.
Example:
{
- "StatusCode": 0,
- "Severity": 1,
- "StatusMessage": "OK",
- "Content":
- { Array of ??? objects }
}
Exceptions
- None
Caching
This method is not cached.
Known issues
- None
Version history
API Version Number | Change description | Changes author |
---|---|---|
1.0 | Initial method design | Harley Cabral |