Facebook Methods description: feed.publishActionOfUser
Publishes a Mini-Feed story to the user corresponding to the session_key parameter, and publishes News Feed stories to the friends of that user who have added the application.
Parameters
| string | api_key | The application key associated with the calling application. |
| string | session_key | The session key of the logged in user. |
| float | call_id | The request’s sequence number. Each successive call for any session must use a sequence number greater than the last. We suggest using the current time in milliseconds, such as PHP’s microtime(true) function. |
| string | sig | An MD5 hash of the current request and your secret key, as described in the authentication guide. |
| string | v | This must be set to 1.0 to use this version of the API. |
| string | format | Optional - desired response format. Either “XML” (default) or “JSON”. |
| string | callback | Optional - wrap the response inside a function call. This is primarily to enable cross-domain javascript requests using the <script> tag, sometimes known as “JSONP“. This works with both XML and JSON. |
| markup | title | The markup displayed in the feed story’s title section |
| markup | body | Optional - The markup displayed in the feed story’s body section |
| string | image_1 | Optional - The URL of an image to be displayed in the News Feed story |
| string | image_1_link | Optional - The URL destination after a click on the image referenced by image_1. |
| string | image_2 | Optional - The URL of an image to be displayed in the News Feed story |
| string | image_2_link | Optional - The URL destination after a click on the image referenced by image_2. |
| string | image_3 | Optional - The URL of an image to be displayed in the News Feed story |
| string | image_3_link | Optional - The URL destination after a click on the image referenced by image_3. |
| string | image_4 | Optional - The URL of an image to be displayed in the News Feed story |
| string | image_4_link | Optional - The URL destination after a click on the image referenced by image_4. |
Example Return XML
<?xml version="1.0" encoding="UTF-8"?> <feed_publishActionOfUser_response xmlns="http://api.facebook.com/1.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://api.facebook.com/1.0/ http://api.facebook.com/1.0/facebook.xsd">1</feed_publishActionOfUser_response>
Response
The function returns 1 on success, 0 on permissions error, or otherwise an error response. Publishing to News Feed requires understanding rules of its operation.
- The title is required, and is limited to 60 displayed characters (excluding tags).
- The a tag is allowed, and there can be zero or one instance in the title.
- One fb:userlink tag is allowed, and the uid parameter must be populated with the user id on whose behalf the action is being published. If there is no such fb:userlink tag found, then one is automatically prepended to the title.
- The fb:name tag is allowed, and there may be multiple instances of this tag.
- No other tags are allowed.
- The body is optional, is limited to 200 displaye characters (excluding tags), and can include the tags fb:userlink, fb:name, a, b, and i.
- Up to 4 images can be displayed, which will be shrunk to fit within 75×75, cached, and formatted by Facebook. Images can either be a URL, or a facebook PID. If it is a URL, you must own the image and grant Facebook the permission to cache it. Each image must have a link associated with it, which must start with http://
- Applications are limited to calling this function ten (10) times for each user in a rolling 48-hour window.
- The story may or may not show up in the user’s friends’ News Feeds, depending on the number and quality of competing stories.
- Developer Note: Unlike feed_publishStoryToUser, there is no unlimited rule for feed_publishActionOfUser, since this method affects all Facebook friends of the developer.
Error codes
| 1 | An unknown error occurred. Please resubmit the request. |
| 2 | The service is not available at this time. |
| 4 | The application has reached the maximum number of requests allowed. More requests are allowed once the time window has completed. |
| 5 | The request came from a remote address not allowed by this application. |
| 100 | One of the parameters specified was missing or invalid. |
| 101 | The api key submitted is not associated with any known application. |
| 102 | The session key was improperly submitted or has reached its timeout. Direct the user to log in again to obtain another key. |
| 103 | The submitted call_id was not greater than the previous call_id for this session. |
| 104 | Incorrect signature. |
Tags: feed.publishActionOfUser(), methods
Related Post
No Comments
No comments yet.
Comments RSS TrackBack Identifier URI
Leave a comment