For developers building video apps, Facebook provides a common video.wants_to_watch
action.
This action can only refer to a common video-type object such as movie
, tv_show
, tv_episode
or video
.
This action and associated object types are automatically added to the App Dashboard when you use the action for the first time.
This document covers the following topics:
You can find platform-specific code samples on how to create, read, update, or delete a video.wants_to_watch
action in the API Reference Guide.
If you publish a video.watches
action that has the same object as a previously published video.wants_to_watch
action, and the wants_to_watch
action is part of a person's 'Movies' or 'TV Shows' section, that collection will be updated so the video originally listed in 'Wants to Watch' is now listed in the 'Watched' collection. Both actions still exist, this only affects how it's displayed on a person's timeline in their collections.
You may want to control the verb tense of some actions to express that an action is ongoing and did not just happen in the past. For example, when publishing a videos.wants_to_watch
action, you may want to post a story that says “Jack wants to watch a movie on MyApp” instead of “...wanted to watch a movie...”. You can accomplish this by adding the expires_in
parameter, which specifies for how many seconds the action will be considered still in progress (hence the present tense). After the action is expired, the tense will automatically switch to the past tense. For example:
curl -F 'access_token=YOUR_TOKEN' \
-F 'movie=https://www.example.com/movie_123.html' \
-F 'expires_in=86400' \
'https://graph.facebook.com/me/video.wants_to_watch'