Represents a collection of Videos for a Page.
Refer to the Video API Publishing guide to learn how to upload and publish a video.
To create an unpublished video for advertising, you will need:
ADVERTISE
task on the Page.pages_manage_ads
and pages_show_list
permissionsTo create and publish a video, you will need:
CREATE_CONTENT
task on the Page.pages_manage_posts
, pages_read_engagement
, and pages_show_list
permissionsvideos
edge from the following paths: Parameter | Description |
---|---|
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 | Default value: true Whether a post about this video is published. Non-published videos cannot be backdated. |
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 | Default value: 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 | Description |
---|---|
382 | The video file you tried to upload is too small. Please try again with a larger file. |
100 | Invalid parameter |
200 | Permissions error |
368 | The action attempted has been deemed abusive or is otherwise disallowed |
389 | Unable to fetch video file from URL. |
6001 | There was a problem uploading your video. Please try again. |
190 | Invalid OAuth 2.0 Access Token |
104 | Incorrect signature |
210 | User not visible |
6000 | There was a problem uploading your video file. Please try again with another file. |
Use the Video endpoint to update a Video.
Use the Video endpoint to delete a Video.