Opensocial.Activity (v0.9)

From VZ Developer Wiki
Jump to: navigation, search

This documentation is not completed yet and will be extended by more examples in future.

opensocial.Activity

Representation of an activity. Activities are rendered with a title and an optional activity body. You may set the title and body directly as strings when calling opensocial.newActivity. However, it is usually beneficial to create activities using Message Templates for the title and body. Users will have many activities in their activity streams, and containers will not show every activity that is visible to a user. To help display large numbers of activities, containers will summarize a list of activities from a given source to a single entry. You can provide Activity Summaries to customize the text shown when multiple activities are summarized. If no customization is provided, a container may ignore your activities altogether or provide default text such as "Bob changed his status message + 20 other events like this."

Activity Summaries will always summarize around a specific key in a key/value pair. This is so that the summary can say something concrete (this is clearer in the example below). Other variables will have synthetic "Count" variables created with the total number of items summarized. Message ID of the summary is the message ID of the main template + ":" + the data key

Example summaries:

<messagebundle> 
 <msg name="LISTEN_TO_THIS_SONG:Artist"> 
  ${Subject.Count} of your friends have suggested listening to songs by ${Artist}! 
 </msg> 
 <msg name="LISTEN_TO_THIS_SONG:Song"> 
  ${Subject.Count} of your friends have suggested listening to ${Song}!
 </msg> 
 <msg name="LISTEN_TO_THIS_SONG:Subject"> 
  ${Subject.DisplayName} has recommended ${Song.Count} songs to you. 
 </msg> 
</messagebundle>

See also: opensocial.Message, opensocial.newActivity, opensocial.requestCreateActivity

Methods

opensocial.Activity.getField

String getField(key, opt_params)
Parameters
Name Type Description
key String The key to get data for; see the Field class for possible values
opt_params Map.<opensocial.DataRequest.DataRequestFields|Object> Additional params to pass to the request.
Returns
Type Description
String The data
Description
Gets the activity data that's associated with the specified key.

opensocial.Activity.getId

String getId()
Returns
Type Description
String The ID
Description
Gets an ID that can be permanently associated with this activity.

opensocial.Activity.setField

setField(key, data)
Parameters
Name Type Description
key String The key to set data for
data String The data to set
Description
Sets data for this activity associated with the given key.

opensocial.Activity.Field

All of the fields that activities can have. See also: opensocial.Activity.getField()


opensocial.Activity.Field.BODY

A string specifying an optional expanded version of an activity. HTML tags are not allowed. This field may be used interchangeably with the string 'body'.

opensocial.Activity.Field.URL

A string specifying the URL that should be attached to the activity. This field may be used interchangeably with the string 'url'.



OpenSocial (v0.9)

gadgets

gadgets.io

gadgets.json

gadgets.Prefs

gadgets.util

gadgets.views

gadgets.flash

gadgets.MiniMessage

gadgets.oauth.Popup

gadgets.rpc

gadgets.skins

gadgets.pubsub

gadgets.Tab

gadgets.TabSet

gadgets.window

gadgets.i18n

opensocial

opensocial.Activity

opensocial.Address

opensocial.Album

opensocial.BodyType

opensocial.Collection

opensocial.CreateActivityPriority

opensocial.DataRequest

opensocial.DataResponse

opensocial.Email

opensocial.Enum

opensocial.Environment

opensocial.EscapeType

opensocial.IdSpec

opensocial.MediaItem

opensocial.Message

opensocial.MessageCollection

opensocial.Name

opensocial.NavigationParameters

opensocial.Organization

opensocial.Permission

opensocial.Person

opensocial.Phone

opensocial.ResponseItem

opensocial.Url

osapi.Request

osapi.BatchRequest

osapi.people

osapi.activities

osapi.appdata

osapi.messages

osapi.http