Facebook Methods description: feed.publishStoryToUser
Publishes a News Feed story to the user corresponding to the session_key parameter.
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_publishStoryToUser_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_publishStoryToUser_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.
- No other tags are allowed.
- The body is optional, is limited to 200 displayed characters (excluding tags), and can include the tags 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 once every 12 hours for each user.
- The story may or may not show up in the user’s News Feed, depending on the number and quality of competing stories.
- Developer Note: If an app developer calls feed.publishStoryToUser for his own user id, the story is always published. This is to allow for testing and display tweaks.
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.publishStoryToUser(), methods
Related Post
No Comments
No comments yet.
Comments RSS TrackBack Identifier URI
Leave a comment
