Represents an individual video on Facebook.
A Video
As long as a video doesn't contain licensed music, you can retrieve it with the following permissions:
user_videos
or user_posts
permission.user_videos
or user_posts
permission. However, in some cases the video owner's privacy settings may not allow your application to access it.source
field will not be returned for Page-owned videos unless the User making the request is an admin of the owning Page.Note: The source URL for reading a posted video changes over time by design. If you save the URL and use it later it will not work.
Nombre | Descripción |
---|---|
Acceso al contenido público de la página | This feature permission may be required. |
GET /v19.0/{video-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
// Returns a `Facebook\FacebookResponse` object
$response = $fb->get(
'/{video-id}',
'{access-token}'
);
} catch(Facebook\Exceptions\FacebookResponseException $e) {
echo 'Graph returned an error: ' . $e->getMessage();
exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
echo 'Facebook SDK returned an error: ' . $e->getMessage();
exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
"/{video-id}",
function (response) {
if (response && !response.error) {
/* handle the result */
}
}
);
/* make the API call */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"/{video-id}",
null,
HttpMethod.GET,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/{video-id}"
parameters:params
HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];
Campo | Descripción |
---|---|
id numeric string | The video ID. |
ad_breaks list<integer> | Time offsets of ad breaks in milliseconds. Ad breaks are short ads that play within a video. |
backdated_time datetime | A user-specified time for when this object was created |
backdated_time_granularity enum | How accurate the backdated time is |
enum | The content category of this video. |
list<numeric string> | Tags that describe the contents of the video. |
created_time datetime | The time the video is created. Note that this may be before the time the video is published. |
custom_labels list<string> | Labels used to describe the video. Unlike content tags, custom labels are not published and only appear in insights data. |
description string | The description of the video. |
embed_html iframe_with_src | The HTML element that may be embedded in a Web page to play the video. |
If this object has a place, the event associated with the place | |
format | The different formats of the video. |
from User|Page | The profile that created the video. |
icon string | The icon that Facebook displays when videos are published to the Feed. |
is_crosspost_video bool | Whether the video is crossposted from other page. |
is_instagram_eligible bool | Whether the video is eligible to be promoted on Instagram |
is_reference_only bool | Whether the video is exclusively used for copyright monitoring |
length float | Duration of this video in seconds. |
enum | The live status of the video |
music_video_copyright MusicVideoCopyright | The music video copyright of this video. This field is only accessible for pages enrolled in Rights Manager for music and will throw a permission error for unenrolled pages. |
permalink_url uri | URL to the permalink page of the video. |
place | Place info |
post_id numeric string | identifier of the post this video belongs to |
unsigned int32 | The public view count of the video post, not aggregated with any other crossposts of the video. |
premiere_living_room_status enum | The status of the Premiere Watch Party, if any |
privacy | Privacy setting for the video. |
bool | Whether a post about this video is published. The post is not scheduled, draft, or ads_post. |
datetime | The time that the video is scheduled to publish. |
source string | A URL to the raw, playable video file. |
status | Object describing the status attributes of a video. |
string | The video title or caption. |
universal_video_id string | The publishers asset management code for this video. |
updated_time datetime | The last time the video or its caption was updated. |
unsigned int32 | The public view count of the video. |
Perímetro | Descripción |
---|---|
Edge<VideoCaption> | Captions for the video. |
Edge<Comment> | Comments made on this |
Edge<Page> | The pages that this video being crossposting shared to. |
Edge<Profile> | People who like this |
Edge<ProfilePictureSource> | The URL for the thumbnail picture of the video. |
Edge<PollSettings> | Settings for polls on the video |
Edge<VideoPoll> | Video polls attached to this video |
Edge<Page> | Sponsor pages tagged in the video. |
Edge<TaggableSubject> | Users tagged in the video. |
Edge<VideoThumbnail> | Thumbnails for the video. |
Edge<InsightsResult> | Total insights from all video posts associated with this video. |
Error | Descripción |
---|---|
100 | Invalid parameter |
283 | That action requires the extended permission pages_read_engagement and/or pages_read_user_content and/or pages_manage_ads and/or pages_manage_metadata |
104 | Incorrect signature |
190 | Invalid OAuth 2.0 Access Token |
200 | Permissions error |
80001 | There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting. |
102 | Session key invalid or no longer valid |
368 | The action attempted has been deemed abusive or is otherwise disallowed |
2500 | Error parsing graph query |
459 | The session is invalid because the user has been checkpointed |
You can publish videos by using the following edges:
polls
edge from the following paths: Parámetro | Descripción |
---|---|
correct_option int64 | Number of the correct option (in order, starting from 1) |
options array<string> | Text options for users to select in order Obligatorio |
question string | Question text Obligatorio |
show_results boolean | True to show the results after voting, otherwise false |
id
in the return type.id
: numeric string, option_ids
: List [Error | Descripción |
---|---|
100 | Invalid parameter |
gaming_clip_create
edge from the following paths: Parámetro | Descripción |
---|---|
duration_seconds float | Valor predeterminado: 60 The duration in seconds to create the clip. Should be a positive number. |
id
: numeric string, Error | Descripción |
---|---|
100 | Invalid parameter |
advideos
edge from the following paths: Parámetro | Descripción |
---|---|
audio_story_wave_animation_handle string | Everstore handle of wave animation used to burn audio story video |
composer_session_id string | SELF_EXPLANATORY |
description UTF-8 string | SELF_EXPLANATORY Supports Emoji |
int64 | end_offset |
int64 | The size of the video file in bytes. Using during chunked upload. |
file_url string | SELF_EXPLANATORY |
fisheye_video_cropped boolean | Whether the single fisheye video is cropped or not |
front_z_rotation float | The front z rotation in degrees on the single fisheye video |
name string | The name of the video in the library. |
og_action_type_id numeric string or integer | SELF_EXPLANATORY |
og_icon_id numeric string or integer | SELF_EXPLANATORY |
og_object_id OG object ID or URL string | SELF_EXPLANATORY |
og_phrase string | SELF_EXPLANATORY |
og_suggestion_mechanism string | SELF_EXPLANATORY |
original_fov int64 | Original field of view of the source camera |
enum {equirectangular, cubemap, half_equirectangular} | Original Projection type of the video being uploaded |
string | SELF_EXPLANATORY |
string | SELF_EXPLANATORY |
react_mode_metadata JSON-encoded string | This metadata is used in clip reaction feature |
referenced_sticker_id numeric string or integer | SELF_EXPLANATORY |
slideshow_spec JSON object | An object required for slideshow video. |
source string | The video, encoded as form data. See the Video Format doc for more details on video formats. |
int64 | The start position in byte of the chunk that is being sent, inclusive. Used during chunked upload. |
time_since_original_post int64 | SELF_EXPLANATORY |
title UTF-8 string | The name of the video being uploaded. Must be less than 255 characters. Special characters may count as more than 1 character. Supports Emoji |
string | Properties used in computing transcode settings for the video |
unpublished_content_type enum {SCHEDULED, SCHEDULED_RECURRING, DRAFT, ADS_POST, INLINE_CREATED, PUBLISHED, REVIEWABLE_BRANDED_CONTENT} | SELF_EXPLANATORY |
enum {start, transfer, finish, cancel} | The phase during chunked upload. Using during chunked upload. |
numeric string or integer | The session ID of this chunked upload. Using during chunked upload. |
string | The chunk of the video, between |
id
: numeric string, upload_session_id
: numeric string, video_id
: numeric string, start_offset
: numeric string, end_offset
: numeric string, success
: bool, skip_upload
: bool, upload_domain
: string, region_hint
: string, xpv_asset_id
: numeric string, is_xpv_single_prod
: bool, transcode_bit_rate_bps
: numeric string, transcode_dimension
: numeric string, should_expand_to_transcode_dimension
: bool, action_id
: string, gop_size_seconds
: numeric string, target_video_codec
: string, target_hdr
: string, maximum_frame_rate
: numeric string, Error | Descripción |
---|---|
200 | Permissions error |
389 | Unable to fetch video file from URL. |
100 | Invalid parameter |
190 | Invalid OAuth 2.0 Access Token |
368 | The action attempted has been deemed abusive or is otherwise disallowed |
222 | Video not visible |
351 | There was a problem with your video file. Please try again with another file, |
390 | There was a problem uploading your video file. Please try again. |
6001 | There was a problem uploading your video. Please try again. |
352 | The video file you selected is in a format that we don't support. |
videos
edge from the following paths: Parámetro | Descripción |
---|---|
audio_story_wave_animation_handle string | Everstore handle of wave animation used to burn audio story video |
enum {BEAUTY_FASHION, BUSINESS, CARS_TRUCKS, COMEDY, CUTE_ANIMALS, ENTERTAINMENT, FAMILY, FOOD_HEALTH, HOME, LIFESTYLE, MUSIC, NEWS, POLITICS, SCIENCE, SPORTS, TECHNOLOGY, VIDEO_GAMING, OTHER} | Content category of this Video |
description UTF-8 string | The text describing a post that may be shown in a story about it. It may include rich text information, such as entities and emojis Supports Emoji |
boolean | Whether the video is embeddable |
int64 | end_offset |
int64 | The size of the entire video file in bytes |
file_url string | Accessible URL of a video file. Cannot be used with |
fisheye_video_cropped boolean | Whether the single fisheye video is cropped or not |
fov int64 | 360 video only: Vertical field of view |
front_z_rotation float | The front z rotation in degrees on the single fisheye video |
guide list<list<int64>> | 360 video only: Guide keyframes data. An array of keyframes, each of which is an array of 3 or 4 elements in the following order: [video timestamp (seconds), pitch (degrees, -90 ~ 90), yaw (degrees, -180 ~ 180), field of view (degrees, 40 ~ 90, optional)], ordered by video timestamp in strictly ascending order |
guide_enabled boolean | 360 video only: Whether Guide is active |
initial_heading int64 | 360 video only: Horizontal camera perspective to display when the video begins |
initial_pitch int64 | 360 video only: Vertical camera perspective to display when the video begins |
original_fov int64 | Original field of view of the source camera |
enum {equirectangular, cubemap, half_equirectangular} | 360 video only: The original projection type of the 360 video being uploaded |
string | The prompt id in prompts or purple rain that generated this post |
string | The prompt tracking string associated with this video post |
published boolean | Valor predeterminado: true Whether a post about this video is published. The post is not scheduled, draft, or ads_post. |
react_mode_metadata JSON-encoded string | This metadata is required for clip reacts feature |
referenced_sticker_id numeric string or integer | Sticker id of the sticker in the post |
numeric string or integer | The video id your uploaded video about to replace |
scheduled_publish_time int64 | Scheduled publish time for group posts. |
slideshow_spec JSON object | Specification of a list of images that are used to generate video |
source string | The video, encoded as form data. This field is required |
spherical boolean | Valor predeterminado: false Set if the video was recorded in 360 format |
int64 | Start byte position of the file chunk |
enum {replace} | Type of replacing video request |
title UTF-8 string | The title of the video Supports Emoji |
string | transcode_setting_properties |
unpublished_content_type enum {SCHEDULED, SCHEDULED_RECURRING, DRAFT, ADS_POST, INLINE_CREATED, PUBLISHED, REVIEWABLE_BRANDED_CONTENT} | Type of unpublished content, such as scheduled, draft or ads_post |
enum {start, transfer, finish, cancel} | Type of chunked upload request |
numeric string or integer | ID of the chunked upload session |
string | The video file chunk, encoded as form data. This field is required during |
id
: numeric string, upload_session_id
: numeric string, video_id
: numeric string, start_offset
: numeric string, end_offset
: numeric string, success
: bool, skip_upload
: bool, upload_domain
: string, region_hint
: string, xpv_asset_id
: numeric string, is_xpv_single_prod
: bool, transcode_bit_rate_bps
: numeric string, transcode_dimension
: numeric string, should_expand_to_transcode_dimension
: bool, action_id
: string, gop_size_seconds
: numeric string, target_video_codec
: string, target_hdr
: string, maximum_frame_rate
: numeric string, Error | Descripción |
---|---|
368 | The action attempted has been deemed abusive or is otherwise disallowed |
200 | Permissions error |
100 | Invalid parameter |
6000 | There was a problem uploading your video file. Please try again with another file. |
210 | User not visible |
190 | Invalid OAuth 2.0 Access Token |
6001 | There was a problem uploading your video. Please try again. |
356 | There was a problem uploading your video file. Please try again. |
390 | There was a problem uploading your video file. Please try again. |
videos
edge from the following paths: Parámetro | Descripción |
---|---|
ad_breaks array | Time offsets of ad breaks in milliseconds. Ad breaks are short ads that play within a video. Place new ad breaks or delete existing ones. |
audio_story_wave_animation_handle string | Everstore handle of wave animation used to burn audio story video |
array | Settings to allow backdated video post.A backdated post needs to be published. |
enum {BEAUTY_FASHION, BUSINESS, CARS_TRUCKS, COMEDY, CUTE_ANIMALS, ENTERTAINMENT, FAMILY, FOOD_HEALTH, HOME, LIFESTYLE, MUSIC, NEWS, POLITICS, SCIENCE, SPORTS, TECHNOLOGY, VIDEO_GAMING, OTHER} | Content category of this video. |
list<numeric string> | Tags that describe the contents of the video. Use search endpoint with
|
numeric string or integer | The video id that the new video post will be reusing |
custom_labels list<string> | Labels used to describe the video. Unlike content tags, custom labels are not published and only appear in insights data. |
description UTF-8 string | The text describing a post that may be shown in a story about it. It may include rich text information, such as entities and emojis. Supports Emoji |
direct_share_status int64 | The status to allow sponsor directly boost the post. |
boolean | Whether the video is embeddable. |
int64 | end_offset |
expiration Object | Time the video expires and whether it will be removed or hidden. |
feed target | Object that controls news feed targeting for this content. Anyone in these demographics will be more likely to see this content, those not will be less likely, but may still see it anyway. Any of the targeting fields shown here can be used, none are required. |
int64 | The size of the entire video file in bytes. |
file_url string | Accessible URL of a video file. Cannot be used with |
fisheye_video_cropped boolean | Whether the single fisheye video is cropped or not |
fov int64 | 360 video only: Vertical field of view |
front_z_rotation float | The front z rotation in degrees on the single fisheye video |
guide list<list<int64>> | 360 video only: Guide keyframes data. An array of keyframes, each of which is an array of 3 or 4 elements in the following order: [video timestamp (seconds), pitch (degrees, -90 ~ 90), yaw (degrees, -180 ~ 180), field of view (degrees, 40 ~ 90, optional)], ordered by video timestamp in strictly ascending order. |
guide_enabled boolean | 360 video only: Whether Guide is active. |
initial_heading int64 | 360 video only: Horizontal camera perspective to display when the video begins. |
initial_pitch int64 | 360 video only: Vertical camera perspective to display when the video begins. |
boolean | is_voice_clip, used to indicate that if a video is used as audio record |
multilingual_data list<Object> | The data of multilingual messages and their dialects |
boolean | If set to |
original_fov int64 | Original field of view of the source camera |
enum {equirectangular, cubemap, half_equirectangular} | 360 video only: The original projection type of the 360 video being uploaded. |
string | The prompt id in prompts or purple rain that generated this post |
string | The prompt tracking string associated with this video post |
published boolean | Valor predeterminado: true Whether a post about this video is published. Non-published videos cannot be backdated. |
react_mode_metadata JSON-encoded string | This metadata is required for clip reacts feature |
reference_only boolean | If set to |
referenced_sticker_id numeric string or integer | Sticker id of the sticker in the post |
numeric string or integer | The video id your uploaded video about to replace |
scheduled_publish_time int64 | Time when the page post about this video should go live, this should be between 10 mins and 6 months from the time of publishing the video. |
boolean | If set to |
slideshow_spec JSON object | Specification of a list of images that are used to generate video. |
boolean | This can be used to enable or prohibit the use of Facebook socialactions (likes, comments, and sharing) on an unlisted video. Default value is false |
source string | The video, encoded as form data. This field is required. |
specified_dialect string | The default dialect of a multilingual post |
spherical boolean | Valor predeterminado: false Set if the video was recorded in 360 format. |
sponsor_id numeric string or integer | Facebook Page id that is tagged as sponsor in the video post |
sponsor_relationship int64 | Sponsor Relationship, such as Presented By or Paid PartnershipWith |
int64 | Start byte position of the file chunk. |
enum {replace} | Type of replacing video request |
targeting target | Object that limits the audience for this content. Anyone not in these demographics will not be able to view this content. This will not override any Page-level demographic restrictions that may be in place. |
thumb image | The video thumbnail raw data to be uploaded and associated with a video. |
title UTF-8 string | The title of the video. Supports Emoji |
string | Properties used in computing transcode settings for the video |
universal_video_id string | The publishers asset management code for this video. |
unpublished_content_type enum {SCHEDULED, SCHEDULED_RECURRING, DRAFT, ADS_POST, INLINE_CREATED, PUBLISHED, REVIEWABLE_BRANDED_CONTENT} | Type of unpublished content, such as scheduled, draft or ads_post. |
enum {start, transfer, finish, cancel} | Type of chunked upload request. |
numeric string or integer | ID of the chunked upload session. |
string | The video file chunk, encoded as form data. This field is required during |
id
: numeric string, upload_session_id
: numeric string, video_id
: numeric string, start_offset
: numeric string, end_offset
: numeric string, success
: bool, skip_upload
: bool, upload_domain
: string, region_hint
: string, xpv_asset_id
: numeric string, is_xpv_single_prod
: bool, transcode_bit_rate_bps
: numeric string, transcode_dimension
: numeric string, should_expand_to_transcode_dimension
: bool, action_id
: string, gop_size_seconds
: numeric string, target_video_codec
: string, target_hdr
: string, maximum_frame_rate
: numeric string, Error | Descripción |
---|---|
6001 | There was a problem uploading your video. Please try again. |
200 | Permissions error |
368 | The action attempted has been deemed abusive or is otherwise disallowed |
190 | Invalid OAuth 2.0 Access Token |
100 | Invalid parameter |
389 | Unable to fetch video file from URL. |
6000 | There was a problem uploading your video file. Please try again with another file. |
210 | User not visible |
382 | The video file you tried to upload is too small. Please try again with a larger file. |
videos
edge from the following paths: Parámetro | Descripción |
---|---|
audio_story_wave_animation_handle string | Everstore handle of wave animation used to burn audio story video |
enum {BEAUTY_FASHION, BUSINESS, CARS_TRUCKS, COMEDY, CUTE_ANIMALS, ENTERTAINMENT, FAMILY, FOOD_HEALTH, HOME, LIFESTYLE, MUSIC, NEWS, POLITICS, SCIENCE, SPORTS, TECHNOLOGY, VIDEO_GAMING, OTHER} | Content category of this video. |
description UTF-8 string |
Supports Emoji |
direct_share_status int64 | The status to allow sponsor directly boost the post. |
boolean | Whether the video is embeddable. |
int64 | end_offset |
int64 | The size of the entire video file in bytes. |
file_url string | Accessible URL of a video file. Cannot be used with |
fisheye_video_cropped boolean | Whether the single fisheye video is cropped or not |
fov int64 | 360 video only: Vertical field of view |
front_z_rotation float | The front z rotation in degrees on the single fisheye video |
guide list<list<int64>> | 360 video only: Guide keyframes data. An array of keyframes, each of which is an array of 3 or 4 elements in the following order: [video timestamp (seconds), pitch (degrees, -90 ~ 90), yaw (degrees, -180 ~ 180), field of view (degrees, 40 ~ 90, optional)], ordered by video timestamp in strictly ascending order. |
guide_enabled boolean | 360 video only: Whether Guide is active. |
initial_heading int64 | 360 video only: Horizontal camera perspective to display when the video begins. |
initial_pitch int64 | 360 video only: Vertical camera perspective to display when the video begins. |
boolean | is_voice_clip, used to indicate that if a video is used as audio record |
no_story boolean | Valor predeterminado: false If set to |
original_fov int64 | Original field of view of the source camera |
enum {equirectangular, cubemap, half_equirectangular} | 360 video only: The original projection type of the 360 video being uploaded. |
enum {enabled, disabled} | Whether the post should appear in RedSpace. |
privacy Privacy Parameter | Determines the privacy settings of the video. If not supplied, this defaults to the privacy level granted to the app in the Login Dialog. This field cannot be used to set a more open privacy setting than the one granted. |
string | The prompt id in prompts or purple rain that generated this post |
string | The prompt tracking string associated with this video post |
react_mode_metadata JSON-encoded string | This metadata is required for clip reacts feature |
referenced_sticker_id numeric string or integer | Sticker id of the sticker in the post |
numeric string or integer | The video id your uploaded video about to replace |
slideshow_spec JSON object | Specification of a list of images that are used to generate video. |
source string | The video, encoded as form data. This field is required. |
spherical boolean | Valor predeterminado: false Set if the video was recorded in 360 format. |
sponsor_id numeric string or integer | Facebook Page id that is tagged as sponsor in the video post |
int64 | Start byte position of the file chunk. |
enum {replace} | Type of replacing video request |
title UTF-8 string | The title of the video Supports Emoji |
string | Properties used in computing transcode settings for the video |
unpublished_content_type enum {SCHEDULED, SCHEDULED_RECURRING, DRAFT, ADS_POST, INLINE_CREATED, PUBLISHED, REVIEWABLE_BRANDED_CONTENT} | Type of unpublished content, such as scheduled, draft or ads_post. |
enum {start, transfer, finish, cancel} | Type of chunked upload request. |
numeric string or integer | ID of the chunked upload session. |
string | The video file chunk, encoded as form data. This field is required during |
string | video_id_original |
id
: numeric string, upload_session_id
: numeric string, video_id
: numeric string, start_offset
: numeric string, end_offset
: numeric string, success
: bool, skip_upload
: bool, upload_domain
: string, region_hint
: string, xpv_asset_id
: numeric string, is_xpv_single_prod
: bool, transcode_bit_rate_bps
: numeric string, transcode_dimension
: numeric string, should_expand_to_transcode_dimension
: bool, action_id
: string, gop_size_seconds
: numeric string, target_video_codec
: string, target_hdr
: string, maximum_frame_rate
: numeric string, Error | Descripción |
---|---|
200 | Permissions error |
368 | The action attempted has been deemed abusive or is otherwise disallowed |
6000 | There was a problem uploading your video file. Please try again with another file. |
100 | Invalid parameter |
190 | Invalid OAuth 2.0 Access Token |
459 | The session is invalid because the user has been checkpointed |
210 | User not visible |
194 | Missing at least one required parameter |
6001 | There was a problem uploading your video. Please try again. |
user_videos
permission is required.publish_pages
permission is required./{video_id}
.Parámetro | Descripción |
---|---|
ad_breaks array | Time offsets of ad breaks in milliseconds. Ad breaks are short ads that play within a video. Place new ad breaks or delete existing ones. |
boolean | If set to true, Pages under your Business Manager will be able to crosspost the video. |
list<VideoPageCrosspostingPermissionParam> | Enable or disable pages from crosspoting the video |
backdated_time datetime | The time when the video post was created. A backdated post needs to be published. |
backdated_time_granularity enum{year, month, day, hour, min, none} | Valor predeterminado: none Accuracy of the backdated time. A backdated post needs to be published. |
call_to_action Object | Call to action for someone viewing a video, such as Reply. You can add a call to action button to an uploaded video. This should be the action you want people to take when they reach the end of the video. Supports Emoji |
enum {BEAUTY_FASHION, BUSINESS, CARS_TRUCKS, COMEDY, CUTE_ANIMALS, ENTERTAINMENT, FAMILY, FOOD_HEALTH, HOME, LIFESTYLE, MUSIC, NEWS, POLITICS, SCIENCE, SPORTS, TECHNOLOGY, VIDEO_GAMING, OTHER} | The content category of this video. |
list<numeric string> | Tags that describe the contents of the video. Use search endpoint with Example:
|
custom_labels list<string> | Labels used to describe the video. Unlike content tags, custom labels are not published and only appear in insights data. |
description UTF-8 string | Description of the video. Supports Emoji |
direct_share_status int64 | The status to allow sponsor directly boost the post. |
boolean | Whether the video is embeddable. |
expiration Object | Time the video expires and whether it will be removed or hidden. |
boolean | If set to true, the video will expire now. |
increment_play_count boolean | Increment count for times video played. |
name UTF-8 string | Video title or caption. Supports Emoji |
preferred_thumbnail_id numeric string | Preferred thumbnail image ID |
privacy Privacy Parameter | Privacy setting for the video. |
boolean | Distributes video item publicly to Feed, Page Timeline, and Page Videos tab. |
boolean | Distributes video item publicly to the Page's Videos tab, but not Feed or Timeline. This field can only be applied on an existing secret video. |
published boolean | Whether the video is published or not. Non-published videos cannot be backdated. |
scheduled_publish_time int64 | Scheduled publish time for the video. |
boolean | Whether the video has likes, comments and shares disabled. |
sponsor_id numeric string or integer | Facebook Page id that is tagged as sponsor in the video post |
sponsor_relationship int64 | Sponsor Relationship, such as Presented By or Paid PartnershipWith |
tags list<numeric string> | Users tagged in the video. |
target numeric string | Target id of the video. |
universal_video_id string | The publishers asset management code for this video. |
success
: bool, Error | Descripción |
---|---|
100 | Invalid parameter |
368 | The action attempted has been deemed abusive or is otherwise disallowed |
200 | Permissions error |
/{video_id}/captions
.Parámetro | Descripción |
---|---|
captions_file file | Caption file in SRT (SubRip Text) format. File name must be in the format filename.locale.srt |
default_locale string | Specify which locale should be used as the default for the video. Can be set to 'none' |
locales_to_delete list<string> | Valor predeterminado: Vector locales of caption to delete |
success
: bool, Error | Descripción |
---|---|
482 | The captions files you selected contain locales that had been applied to video, please remove and try again. |
387 | There was a problem uploading your captions file. Please try again. |
386 | You uploaded a .SRT file with an incorrect file name. Please use this format: filename.en_US.srt |
100 | Invalid parameter |
user_videos
permission is required.publish_pages
permission is required.publish_pages
permission to delete a video./{video_id}
.success
: bool, Error | Descripción |
---|---|
100 | Invalid parameter |
368 | The action attempted has been deemed abusive or is otherwise disallowed |
200 | Permissions error |
190 | Invalid OAuth 2.0 Access Token |
/act_{ad_account_id}/advideos
.Parámetro | Descripción |
---|---|
video_id video ID | Ad account library video ID Obligatorio |
success
: bool, Error | Descripción |
---|---|
613 | Calls to this api have exceeded the rate limit. |
100 | Invalid parameter |