OpenSocial JavaScript Features Supported by YAP

Activity

Supported Activity Fields

YAP supports opensocial.CreateActivityPriority.LOW for requestCreateActivity but does not support opensocial.CreateActivityPriority.HIGH. Requests for HIGH are treated the same as LOW.

Because OpenSocial does not specify ActivityRequestFields, offsets and limits (using "first" and "max") are not supported.

YAP supports the following Activity fields:

Application Data

YAP supports up to 1,024 bytes of data per key and up to 1 MB per application.

Messaging

YAP does not support requestSendMessage and requestShareApp.

Person and People

Supported PeopleRequest Fields

YAP supports only the following PeopleRequest fields:

YAP does not support other PeopleRequest fields, including FILTER, PROFILE_DETAILS, and SORT_ORDER. YAP behaves as if these fields are set to ALL.

Supported DataRequest Fields

YAP supports only the ESCAPE_TYPE DataRequest field. All requests behave as if ESCAPE_TYPE is set to NONE.

Using Environment.supportsField

The Environment.supportsField method returns true if the specified field is supported by the OpenSocial container. The method does not check to see if the field value exists for a given user.

A user might not provide information such as age, gender, and time zone. If this information is not provided, it is not returned in the response.

The supportsField method is useful for checking if the container stores data for a certain field, for example, location. If the container does not support location, then the application must store the location data. If the container does support location, but location is undefined, then the application can prompt the user to update location in the container's preferences.

Permissions

If your Yahoo! Open Application makes OpenSocial calls, on the Project Details page specify Read (or Read/Write) for the following data:

  • Yahoo! Profiles
  • Yahoo! Updates

Gadget Core APIs

YAP supports gadgets.io.makeRequest. Support for other Gadget Core APIs is not guaranteed.

Table of Contents