OpenSocial v0.9 MediaItemComments

Base URI

The base URI for mediaItemComments on MySpace is http://opensocial.myspace.com/roa/09/mediaitemcomments. This endpoint currently supports only GET.

URI Parameters

Parameters are accepted as part of the URI. URIs are of the following forms: This url as a GET will return all the comments.

• http://opensocial.myspace.com/roa/09/mediaitemcomments/{personId}/@self/{albumId}/{mediaItemId}

{personId}

This can be one of the following values:

• @me: Refers to the current user. @me can only be passed in when using the xoauth_requestor_id query string parameter or when passing in an OAuth token.
• An integer value: MySpace IDs are integers. For example, Tom is 6221. 6221 is a valid integer value.
• myspace.com.person.[integer value]: PersonIDs also support type identifier prepended to the integer value. Tom's value is myspace.com.person.6221.

{albumId}

The albumId indicates which group of media items from a single album from the group identified by {selector} should be returned. This is used when an application wants to display the contents of a single album. Valid values are -

• An integer value: Gives the integer identifier of the album.
• myspace.com.album.[integer value]
• @videos if the media items are videos. On MySpace, videos do not belong to specific albums.

{mediaItemId}

The mediaItemId indicates which single media item from the album identified by {albumId} should be returned. This is used when an application wants to display a single mediaItem. Valid values are -

• An integer value: Gives the integer identifier of the mediaItem.
• myspace.com.mediaItem.image.[integer value] for image
• myspace.com.mediaItem.video.[integer value] for video

Notes

• The following are the fields of the mediaItemComments object.
  • Collection of comment objects
  • personId
  • id
  • isFiltered
  • isSorted
  • isUpdatedSince
  • itemsPerPage
  • startIndex
  • totalResults
• The following are the fields of the comment object. The fields marked in bold are default fields and will always be returned. Remaining fields will be returned whenever available.
  • author
  • commentId
  • body
  • postedDate
  • culture
• author is an OpenSocial 0.9 Person type object. The following fields are supported; those marked in bold are default fields and will always be returned.
  • id
  • displayName
  • profileUrl
  • thumbnailUrl
• By default, the id of the comment author will be added to the result set, add the query parameter fields=author to get more information on the author.
• If the comment author is blocking the app, it will set displayName field of the author as "Private User" along with a null id.
• The maximum number of mediaItem comments that an app can request is 100 (count=100).
• To fetch comments of a mediaItem, app needs same permission as it requires to fetch metadata of that mediaItem. Please see MediaItems permission model