The orkut Share API allows website owners to enable their visitors to share the website content with visitor's orkut friends. Users can optionally promote the content among their friends.
- Using the API
- HTTP GET API
- GET Endpoint
Using the API
renders the share button on the webpage as
When users click this button they are prompted to login to orkut if they are not already logged in. They are then shown a preview of the content that will be posted to orkut with an option to also promote what they are sharing. Once the user confirms, the content will be shared with their orkut friends.
Rendering within orkut
The shared content appears in the 'Updates from my friends' section on orkut. If the user had checked 'Promote to your friends,' it also appears in the upper right hand corner of the orkut friends' home and profile pages, alternating with formal advertisements.
Static class — google.orkut.share.Button
Constructor — google.orkut.share.Button
Renders the sharing button into the specified (div) element.
|en||English (default if detection fails)|
Class — google.orkut.share.Field
Instances of this class are used as keys in the sharing configuration dictionary. There is no need to instantiate an object of this class. Available configuration fields are present as static members of this class, and possibly other classes.
Fields — google.orkut.share.Field
||Always 'orkut.com' (reserved for future use).|
||Body of the shared item, a summary of the activity being shared.|
||Title of the shared item.|
||Thumbnail image to be included in shared item.|
||Comment by the user on the shared item.|
||Destination url for the link in the shared item.|
Class — google.orkut.share.Connection
Constructor — google.orkut.share.Connection
overrides parameters passed to the
constructor and send method of
dictionaries containing settings for the shared item. Setting passed to send
override settings passed to the constructor. The keys of this dictionary are
instances of the
google.orkut.share.Field and the values are raw
strings with constraints as specified in the documentation for the
HTTP GET API
The web developer can submit a GET request using a form and the sharing service will use the target window to complete the sharing flow. At the end of the flow the it will close the target window. An additional consideration is that the authentication for sharing is based on OAuth. So it is required that the target window display the location bar.
HTTP GET request in the example would look as follows:
|nt||Must be set to "orkut.com". Reserved for future use.||Required|
|du||URL of content being shared.||Required|
|tt||Title of the shared item, should be plain text.||Required|
|cn||Content to be shared.||Optional|
|uc||User comment on shared item.||Optional|
|tn||A thumbnail image to be included in the shared item.||Optional|
Note: All parameter values must be URL encoded. In the future the set of required fields may change.
<html> <head> <title>An interesting Page</title> </head> <body> <h1>Hello World</h1> <form method="GET" target="_blank" action="http://promote.orkut.com/preview"> <input type="hidden" name="nt" value="orkut.com"/> <input type="hidden" name="tt" value="Something interesting"/> <input type="hidden" name="du" value="http://example.com/"/> <input type="hidden" name="cn" value="An interesting page to visit."/> <input type="submit" name="share" value="Share"/> </form> </body> </html>
How much does it cost to use?
This feature is 100% free to both publishers and orkut users.
Can users edit or delete the content, once they have shared it?
Yes. This content will appear in the 'My updates' section, which users can delete anytime. If the content is promoted, they can pause or delete it from the 'My promotions' section.
Are users and friends guaranteed to see the shared content from my site?
Users can share content with their friends. However, some of those friends may not see the shared content because there are limits on the activities that show up by default and the number of promotions that can be sent.
How do I get statistics of how many users shared out of my site?
At this time there are no analytics and reports offered to website publishers for this feature. You can look at URL params from your own weblogs to see the level of shared activity.