* See also: * newActivity() *
* ** Note: * If this is the first activity that has been created for the user and * the request is marked as HIGH priority then this call may open a user flow * and navigate away from your gadget. * * If the container does not support this method the callback will be called * with a opensocial.ResponseItem. The response item will have its error code * set to NOT_IMPLEMENTED. * * @param {opensocial.Activity} activity The * activity to create * @param {opensocial.CreateActivityPriority} priority The * priority for this * request * @param {Function} opt_callback The function to call once the request has been * processed. This callback will either be called or the gadget will be * reloaded from scratch. This function will be passed one parameter, an * opensocial.ResponseItem. The error code will be set to reflect whether * there were any problems with the request. If there was no error, the * activity was created. If there was an error, you can use the response * item's getErrorCode method to determine how to proceed. The data on the * response item will not be set. * * @member opensocial */ opensocial.requestCreateActivity = function(activity, priority, opt_callback) {}; /** * @static * @class * The priorities a create activity request can have. *
See also: * * opensocial.requestCreateActivity() *
* * @name opensocial.CreateActivityPriority */ opensocial.CreateActivityPriority = { /** * If the activity is of high importance, it will be created even if this * requires asking the user for permission. This may cause the container to * open a user flow which may navigate away from your gagdet. */ HIGH : 'HIGH', /** * If the activity is of low importance, it will not be created if the * user has not given permission for the current app to create activities. * With this priority, the requestCreateActivity call will never open a user * flow. */ LOW : 'LOW' }; /** * Returns true if the current gadget has access to the specified * permission. If the gadget calls opensocial.requestPermission and permissions * are granted then this function must return true on all subsequent calls. * * @param {opensocial.Permission} permission * The permission * @return {Boolean} * True if the gadget has access for the permission; false if it doesn't * * @member opensocial */ opensocial.hasPermission = function(permission) {}; /** * Requests the user to grant access to the specified permissions. If the * container does not support this method the callback will be called with a * opensocial.ResponseItem. The response item will have its error code set to * NOT_IMPLEMENTED. * * @param {Array.<opensocial.Permission>} permissions * The permissions to request * from the viewer * @param {String} reason Displayed to the user as the reason why these * permissions are needed * @param {Function} opt_callback The function to call once the request has been * processed; either this callback will be called or the gadget will be * reloaded from scratch. This function will be passed one parameter, an * opensocial.ResponseItem. The error code will be set to reflect whether * there were any problems with the request. If there was no error, all * permissions were granted. If there was an error, you can use * opensocial.hasPermission to check which permissions are still denied. The * data on the response item will be set. It will be an array of the * opensocial.Permissions that were granted. * * @member opensocial */ opensocial.requestPermission = function(permissions, reason, opt_callback) {}; /** * @static * @class * * The permissions an app can ask for. * *
* See also:
*
* opensocial.hasPermission(),
*
* opensocial.requestPermission()
*
* @name opensocial.Permission
*/
opensocial.Permission = {
/**
* Access to the viewer person object
*/
VIEWER : 'viewer'
};
/**
* Gets the current environment for this gadget. You can use the environment to
* make queries such as what profile fields and surfaces are supported by this
* container, what parameters were passed to the current gadget, and so on.
*
* @return {opensocial.Environment}
* The current environment
*
* @member opensocial
*/
opensocial.getEnvironment = function() {};
/**
* Creates a data request object to use for sending and fetching data from the
* server.
*
* @return {opensocial.DataRequest} The
* request object
* @member opensocial
*/
opensocial.newDataRequest = function() {};
/**
* Creates an activity object,
* which represents an activity on the server.
*
* See also: * requestCreateActivity(), *
* *It is only required to set one of TITLE_ID or TITLE. In addition, if you * are using any variables in your title or title template, * you must set TEMPLATE_PARAMS.
* *Other possible fields to set are: URL, MEDIA_ITEMS, BODY_ID, BODY, * EXTERNAL_ID, PRIORITY, STREAM_TITLE, STREAM_URL, STREAM_SOURCE_URL, * and STREAM_FAVICON_URL.
* *Containers are only required to use TITLE_ID or TITLE, and may choose to * ignore additional parameters.
* *See Fields are supported for * more details.
* * @param {Map.<opensocial.Activity.Field, Object>} params * Parameters defining the activity. * @return {opensocial.Activity} The new * activity object * @member opensocial */ opensocial.newActivity = function(params) {}; /** * Creates a media item associated with an activity. * Represents images, movies, and audio. * Used when creating activities on the server. * * @param {String} mimeType * MIME type of the * media * @param {String} url Where the media can be found * @param {Map.<opensocial.Activity.MediaItem.Field, Object>} opt_params * Any other fields that should be set on the media item object; * all of the defined * Fields * are supported * * @return {opensocial.Activity.MediaItem} The new * media item object * @member opensocial */ opensocial.newActivityMediaItem = function(mimeType, url, opt_params) {}; /** * Creates a media item associated with an activity. * Represents images, movies, and audio. * Used when creating activities on the server. * * @param {String} body The main text of the message. * @param {Map.<opensocial.Message.Field, Object>} opt_params * Any other fields that should be set on the message object; * all of the defined * Fields * are supported * * @return {opensocial.Message} The new * message object * @member opensocial */ opensocial.newMessage = function(body, opt_params) {};