video.watches

An action representing someone watching video content.

Create
/* make the API call */
FB.api(
    "/me/video.watches",
    "POST",
    {
        "movie": "http:\/\/samples.ogp.me\/453907197960619",
        "tv_show": "http:\/\/samples.ogp.me\/413802348663468",
        "tv_episode": "http:\/\/samples.ogp.me\/335419676534648",
        "episode": "http:\/\/samples.ogp.me\/335419676534648",
        "video": "http:\/\/samples.ogp.me\/467235199955838"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
NSDictionary *params = @{
  @"movie": @"http://samples.ogp.me/453907197960619",
  @"tv_show": @"http://samples.ogp.me/413802348663468",
  @"tv_episode": @"http://samples.ogp.me/335419676534648",
  @"episode": @"http://samples.ogp.me/335419676534648",
  @"video": @"http://samples.ogp.me/467235199955838",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/me/video.watches"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
Bundle params = new Bundle();
params.putString("movie", "http://samples.ogp.me/453907197960619");
params.putString("tv_show", "http://samples.ogp.me/413802348663468");
params.putString("tv_episode", "http://samples.ogp.me/335419676534648");
params.putString("episode", "http://samples.ogp.me/335419676534648");
params.putString("video", "http://samples.ogp.me/467235199955838");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/me/video.watches",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'POST',
  '/me/video.watches',
  array (
    'movie' => 'http://samples.ogp.me/453907197960619',
    'tv_show' => 'http://samples.ogp.me/413802348663468',
    'tv_episode' => 'http://samples.ogp.me/335419676534648',
    'episode' => 'http://samples.ogp.me/335419676534648',
    'video' => 'http://samples.ogp.me/467235199955838',
  )
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
POST /v2.10/me/video.watches HTTP/1.1
Host: graph.facebook.com

movie=http%3A%2F%2Fsamples.ogp.me%2F453907197960619&tv_show=http%3A%2F%2Fsamples.ogp.me%2F413802348663468&tv_episode=http%3A%2F%2Fsamples.ogp.me%2F335419676534648&episode=http%3A%2F%2Fsamples.ogp.me%2F335419676534648&video=http%3A%2F%2Fsamples.ogp.me%2F467235199955838
curl -X POST \
     -d "movie=http%3A%2F%2Fsamples.ogp.me%2F453907197960619&tv_show=http%3A%2F%2Fsamples.ogp.me%2F413802348663468&tv_episode=http%3A%2F%2Fsamples.ogp.me%2F335419676534648&episode=http%3A%2F%2Fsamples.ogp.me%2F335419676534648&video=http%3A%2F%2Fsamples.ogp.me%2F467235199955838" \
        https://graph.facebook.com/v2.10/me/video.watches

Request

NameTypeDescription
FIELDS
episodeReferenceAn object representing an episode
movieReferenceAn object representing a movie
tv_episodeReferenceAn object representing a TV episode
tv_showReferenceAn object representing a TV show
videoReferenceAn object representing any other type of video content
INHERITED FIELDS
created_timeDateTimeThe time that the action was created
end_timeDateTimeThe time that the user ended
expires_inIntegerThe amount of time from the publish_time that the action will expire
fb:explicitly_sharedBooleanThe user is explicitly sharing this action
messageStringA message attached to this action
no_feed_storyBooleanDo not post this action to the feed
placePlaceThe place that the action took place
refStringA <50 character string identifier for tracking and insights
start_timeDateTimeThe time that the user started
tagsArray<Profile>Any other users that performed the action

Response

NameTypeDescription
idWatchA Watch action id
Read
/* make the API call */
FB.api(
    "/me/video.watches",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/me/video.watches"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/me/video.watches",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'GET',
  '/me/video.watches'
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
GET /v2.10/me/video.watches HTTP/1.1
Host: graph.facebook.com
curl https://graph.facebook.com/v2.10/me/video.watches

Request

NameTypeDescription
idWatchA Watch action id

Response

NameTypeDescription
FIELDS
episodeReferenceAn object representing an episode
movieReferenceAn object representing a movie
tv_episodeReferenceAn object representing a TV episode
tv_showReferenceAn object representing a TV show
videoReferenceAn object representing any other type of video content
INHERITED FIELDS
end_timeDateTimeThe time that the user ended
imageArray<ActionImage>
image:urlURL
image:secure_urlURL
image:typeString
image:widthInteger
image:heightInteger
image:altString
image:user_generatedBoolean
messageStringA message attached to this action
no_feed_storyBooleanDo not post this action to the feed
placePlaceThe place that the action took place
publish_timeDateTimeThe time that the action was published
refStringA <50 character string identifier for tracking and insights
start_timeDateTimeThe time that the user started
tagsArray<Profile>Any other users that performed the action
Update
/* make the API call */
FB.api(
    "/id_from_create_call",
    "POST",
    {
        "movie": "http:\/\/samples.ogp.me\/453907197960619",
        "tv_show": "http:\/\/samples.ogp.me\/413802348663468",
        "tv_episode": "http:\/\/samples.ogp.me\/335419676534648",
        "episode": "http:\/\/samples.ogp.me\/335419676534648",
        "video": "http:\/\/samples.ogp.me\/467235199955838"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
NSDictionary *params = @{
  @"movie": @"http://samples.ogp.me/453907197960619",
  @"tv_show": @"http://samples.ogp.me/413802348663468",
  @"tv_episode": @"http://samples.ogp.me/335419676534648",
  @"episode": @"http://samples.ogp.me/335419676534648",
  @"video": @"http://samples.ogp.me/467235199955838",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/id_from_create_call"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
Bundle params = new Bundle();
params.putString("movie", "http://samples.ogp.me/453907197960619");
params.putString("tv_show", "http://samples.ogp.me/413802348663468");
params.putString("tv_episode", "http://samples.ogp.me/335419676534648");
params.putString("episode", "http://samples.ogp.me/335419676534648");
params.putString("video", "http://samples.ogp.me/467235199955838");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/id_from_create_call",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'POST',
  '/id_from_create_call',
  array (
    'movie' => 'http://samples.ogp.me/453907197960619',
    'tv_show' => 'http://samples.ogp.me/413802348663468',
    'tv_episode' => 'http://samples.ogp.me/335419676534648',
    'episode' => 'http://samples.ogp.me/335419676534648',
    'video' => 'http://samples.ogp.me/467235199955838',
  )
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
POST /v2.10/id_from_create_call HTTP/1.1
Host: graph.facebook.com

movie=http%3A%2F%2Fsamples.ogp.me%2F453907197960619&tv_show=http%3A%2F%2Fsamples.ogp.me%2F413802348663468&tv_episode=http%3A%2F%2Fsamples.ogp.me%2F335419676534648&episode=http%3A%2F%2Fsamples.ogp.me%2F335419676534648&video=http%3A%2F%2Fsamples.ogp.me%2F467235199955838
curl -X POST \
     -d "movie=http%3A%2F%2Fsamples.ogp.me%2F453907197960619&tv_show=http%3A%2F%2Fsamples.ogp.me%2F413802348663468&tv_episode=http%3A%2F%2Fsamples.ogp.me%2F335419676534648&episode=http%3A%2F%2Fsamples.ogp.me%2F335419676534648&video=http%3A%2F%2Fsamples.ogp.me%2F467235199955838" \
        https://graph.facebook.com/v2.10/id_from_create_call

Request

NameTypeDescription
FIELDS
episodeReferenceAn object representing an episode
movieReferenceAn object representing a movie
tv_episodeReferenceAn object representing a TV episode
tv_showReferenceAn object representing a TV show
videoReferenceAn object representing any other type of video content
INHERITED FIELDS
end_timeDateTimeThe time that the user ended
expires_inIntegerThe amount of time from the publish_time that the action will expire
messageStringA message attached to this action
placePlaceThe place that the action took place
refStringA <50 character string identifier for tracking and insights
tagsArray<Profile>Any other users that performed the action

Response

NameTypeDescription
idWatchA Watch action id
Delete
/* make the API call */
FB.api(
    "/id_from_create_call",
    "DELETE",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/id_from_create_call"
                                      parameters:params
                                      HTTPMethod:@"DELETE"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/id_from_create_call",
    null,
    HttpMethod.DELETE,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'DELETE',
  '/id_from_create_call'
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
DELETE /v2.10/id_from_create_call HTTP/1.1
Host: graph.facebook.com
curl -X DELETE \
     -d "" \
        https://graph.facebook.com/v2.10/id_from_create_call

Request

NameTypeDescription
idWatchA Watch action id

Response

If successful, returns boolean true
true
If not successful, returns an error JSON object
{
  "error":
  {
    "message":ERROR_MESSAGE,
    "type":ERROR_TYPE,
    "code":ERROR_CODE
  }
}