图谱 API 版

Page Live Videos

2024 年 6 月 10 日，Meta 将推出一些新要求。账户必须先满足这些要求，才能在 Facebook 上开始直播。新要求如下：

Facebook 账户存在时长必须不少于 60 天
Facebook 公共主页或专业模式个人主页必须拥有至少 100 名粉丝

读取

你无法在此端点执行该操作。

创建

你可以通过下列路径向 live_videos 连线发出 POST 请求：

/{page_id}/live_videos

发布到这个连线会创建 a LiveVideo 。

参数

参数	描述
`content_tags` list<numeric string>	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` array<JSON object>	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` numeric string	page_id 必填
`action` enum {ENABLE_CROSSPOSTING, DISABLE_CROSSPOSTING, ENABLE_CROSSPOSTING_AND_CREATE_POST}	action 必填
`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 live video.
`donate_button_charity_id` numeric string or integer	Specifies the ID of the charity for which a donate button will be added to the live video.
`enable_backup_ingest` boolean	Set this to true to enable a backup ingest url. stop_on_delete_stream defaults to false when set
`encoding_settings` string	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` Live Video Event Parameter	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` 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
`game_show` JSON object	Configure this live stream to be a game show
`game_type` enum {KNOCKOUT}	game_type 必填
`is_spherical` boolean	Flag that denotes the broadcast is a 360 live broadcast.
`original_fov` int64	Original field of view of the camera
`privacy` Privacy Parameter	Privacy for this live video.
`product_items` list<numeric string>	Products which will be shown with live videos.
`projection` enum {EQUIRECTANGULAR, CUBEMAP, HALF_EQUIRECTANGULAR}	Flag that denotes expected projection for 360 live streams. The default value is EQUIRECTANGULAR.
`published` boolean	Set this to false to preview the stream before going live. `Deprecated. Prefer setting the status instead.`
`schedule_custom_profile_image` image	Custom image that will appear in the scheduled live story and lobby.
`spatial_audio_format` enum {ambiX_4}	Denotes the format of the spatial audio stream. When unspecified audio is presumed to be mono or stereo.
`status` enum {UNPUBLISHED, LIVE_NOW, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_CANCELED}	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` enum {MONO, LEFT_RIGHT, TOP_BOTTOM}	Set this parameter to the stereoscopic mode for this video.
`stop_on_delete_stream` boolean	Set this to true if stream should be stopped when deleteStream RTMP command received.
`targeting` target	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` Object
`countries` list<string>
`regions` list<Object>
`key` int64
`cities` list<Object>
`key` int64
`zips` list<Object>
`key` string
`locales` list<string>
`excluded_countries` list<string>
`excluded_regions` list<int64>
`excluded_cities` list<int64>
`excluded_zipcodes` list<string>
`timezones` list<int64>
`age_min` enum {13, 15, 18, 21, 25}
`title` string	The title of the live video. Maximum 254 characters.

返回类型

这个端点支持先写后读，并会读取返回类型中 id 代表的节点。

Struct {

id: numeric string,

stream_url: string,

secure_stream_url: string,

stream_secondary_urls: List [

string

secure_stream_secondary_urls: List [

string

dash_ingest_url: string,

dash_ingest_secondary_urls: List [

string

event_id: numeric string,

}

错误代码

错误	描述
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.

更新

你无法在此端点执行该操作。

删除

你无法在此端点执行该操作。