On June 10th, 2024, Meta is launching new requirements that must meet before an account can go live on Facebook. The new requirements are as follows:
Visit our Help Center
to learn more about this change.
live_videos
edge from the following paths:
content_tags
Tags that describe the contents of the video. Use search endpoint with type=adinterest
to get possible IDs.
Example:
~~~~
/search?type=adinterest&q=couscous
~~~~
crossposting_actions
List of desired changes to crossposting for this broadcast. Each change must provide a page_id
and action
. Example:
[ {page_id: 1234, action: 'enable_crossposting'}, {page_id: 4567, action: 'enable_crossposting_and_create_post'} ]
Available action types:
enable_crossposting
: Enables crossposting for this broadcast with the Page if it is not currently enabled. No change if crossposting is already enabled with the Page for this broadcast.disable_crossposting
: Disables crossposting for this broadcast with the Page if it is currently enabled. No change if crossposting is not already enabled with the Page for this broadcast.enable_crossposting_and_create_post
: Same as enable_crossposting
, but will also create a post as the Page. The post will be created even if crossposting is already enabled for the Page. This option is subject to your live crossposting relationships
and will fail for Pages without the required permission.When used with a Live Online Event, this will apply to the event.
page_id
page_id
action
action
custom_labels
Labels used to describe the video. Unlike content tags, custom labels are not published and only appear in insights data.
description
The description of the live video.
donate_button_charity_id
Specifies the ID of the charity for which a donate button will be added to the live video.
enable_backup_ingest
Set this to true to enable a backup ingest url. stop_on_delete_stream defaults to false when set
encoding_settings
Identifier of the encoding settings group the broadcaster is using for this stream. This parameter is currently only in use for live-360 broadcasts. The value to be passed to this parameter is the value of the identifier
key of the encoding settings preset. Encoding presets can be found by querying the /broadcaster_encoding_settings
Graph API endpoint ( GET
query).
event_params
Parameters specific to Live Online Event broadcast. If start_time
(unix timecode) is set, LOE's start time will be updated. Also, cover
(url) uploads an image to use as the cover photo for the event.
Example: { start_time: 1641013200, cover: 'https://your.url/image.jpg', }
fisheye_video_cropped
Whether the single fisheye video is cropped or not
front_z_rotation
The front z rotation in degrees on the single fisheye video
game_show
Configure this live stream to be a game show
game_type
game_type
is_spherical
Flag that denotes the broadcast is a 360 live broadcast.
original_fov
Original field of view of the camera
privacy
Privacy for this live video.
product_items
Products which will be shown with live videos.
projection
Flag that denotes expected projection for 360 live streams. The default value is EQUIRECTANGULAR.
published
Set this to false to preview the stream before going live.
Deprecated. Prefer setting the status instead.
schedule_custom_profile_image
Custom image that will appear in the scheduled live story and lobby.
spatial_audio_format
Denotes the format of the spatial audio stream. When unspecified audio is presumed to be mono or stereo.
status
The status of the broadcast. A LIVE_NOW
broadcast is currently live and visible to users. An UNPUBLISHED
broadcast is in preparation; it's not visible to other users, and it may be automatically deleted after several hours in this state. (Consider using the SCHEDULED
states to create a planned, future broadcast.)
stereoscopic_mode
Set this parameter to the stereoscopic mode for this video.
stop_on_delete_stream
Set this to true if stream should be stopped when deleteStream RTMP command received.
targeting
Object that limits the audience for this content. Anyone not in these demographics will not be able to view this content.
When used with a Live Online Event, this will apply to the event.
geo_locations
countries
regions
key
cities
key
zips
key
locales
age_min
title
The title of the live video. Maximum 254 characters.
id
in the return type.id
: numeric string,stream_url
: string,secure_stream_url
: string,stream_secondary_urls
: List [ secure_stream_secondary_urls
: List [ dash_ingest_url
: string,dash_ingest_secondary_urls
: List [ event_id
: numeric string,Error | Description |
---|---|
200 | Permissions error |
368 | The action attempted has been deemed abusive or is otherwise disallowed |
100 | Invalid parameter |
190 | Invalid OAuth 2.0 Access Token |
1005 | Fail to upload cover photo. |
102 | Session key invalid or no longer valid |
1000 | Invalid time for an event. |
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. |