channels.getChannelInfo

Syntax

array channels.getChannelInfo ( mixed id, int vhost = NULL )

Argument Info

NameTypeRequiredDefault valueDescription
idmixedRequirednoneThe ID of the channel you want information about.
vhostintOptionalNULLThe vhost ID that the channel belongs to.

Response

This is the response received on success of the getChannels method call. If there are no channels in your vhost you will be returned an empty XML response.

NameTypeDescriptionPossible Values
idINTThe current channel ID.INT channel ID
createdYYYY-MM-DD HH:MM:SSThe date the channel was created.YYYY-MM-DD HH:MM:SS
vhostINTThe vhost ID.INT
nameSTRINGThe channel name defined in MediaFactory.STRING
shortnameSTRINGThe given short given retrieved in MediaFactory. By Default this is the channel name, all lowercase and have spaces " " replaced by underscores "_".STRING
parentchannelINTThe ID of the current channel's parent. This is for nested channel lists.INT
thumburlSTRINGOBSOLETESTRING
statusINTThe moderation status of the current channel.0,1,2,3,4
descriptionSTRINGA short summary for the purpose of the channel. This is defined in MediaFactory.STRING
readonlyINTOBSOLETE0/1
disableembedINTDEPRECATED0/1
modemailacceptedINTThe ID of the email to use for Media approved in the channel.0/1
modemaildeniedINTThe moderation email ID of the email to use for Media denied in the channel.0/1
emailaddressSTRINGEmail address to be used for media intake through email. Leave empty to disable, must be unique.STRING
defaultsortSTRINGThe default sort order of the media within the channel'name ASC', 'name DESC', 'shortname ASC', 'shortname DESC', 'id ASC', 'id DESC', 'createdDate ASC', 'createdDate DESC'
visibilitySTRINGThe current visibility of the channelSHOWN, HIDDEN
geoblockingSTRINGA list of accepted country codes for the channel to display content from. This value is set in the channel settings.CA,US,AU
groupidDEPRECATEDDEPRECATEDDEPRECATED
groupnameDEPRECATEDDEPRECATEDDEPRECATED

Return Values

FieldDescriptionPossible Values
idachannel idbN/A
nameachannelnamebN/A
createdacreationdatebN/A
groupidathe id of the parent channel, if any (depreciated)bN/A
groupnameathe name of the parent channel (deprecated)bN/A
parentchannelathe id of the parent channel, if anybN/A
descriptionadescription for the channelbN/A
geoblockingaeach item is a country code that is allowed to view the media item, if empty then all countries may view the mediabN/A
visibilitya"SHOWN or "HIDDEN". Hiding a channel does not make the media within private, hidden or otherwise inaccessible.bN/A