그래프 API
그래프 API 버전

Live Video

Represents a live video broadcast. Refer to the Live Video API documentation for additional usage information.

읽기

Get fields and edges on a LiveVideo.

2021년 9월 14일부터 엔드포인트의 필수 권한이 없는 앱에서 보낸 버전 12.0 이상 호출에 대해 다음 필드에 오류가 발생합니다. 이 변경 사항은 2021년 12월 13일부터 모든 버전에 적용됩니다.

  • copyright

새로운 페이지 환경

This endpoint is supported for 새로운 페이지 환경.

예

Graph API Explorer
GET /v19.0/{live-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(
    '/{live-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(
    "/{live-video-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{live-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:@"/{live-video-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
그래프 API를 사용하는 방법을 알아보려면 그래프 API 사용 가이드를 읽어보세요.

매개변수

매개변수설명
target_token
string

A target token recently returned by the speed test API

필드

필드설명
id
numeric string

The live video ID.

ad_break_config
LiveVideoAdBreakConfig

The ad break configurations for clients implementing triggering an ad break ui. Contains ad break eligibility and constants to render the ui. In order to use this, the page hosting the broadcast needs to be whitelisted.

ad_break_failure_reason
enum

Ad Break failure reason

broadcast_start_time
datetime

The time the video was initially published

copyright
VideoCopyright

The copyright information for the live video

creation_time
datetime

The creation time of the live video

dash_ingest_url
string

The dash ingest stream URL of the live video

dash_preview_url
string

Preview URL for dash player

description
string

The description of the live video

embed_html
iframe_with_src

The embed html of the live video

기본
from
User|Page

The originator of the live video

ingest_streams
list<LiveVideoInputStream>

Individual ingest streams.

is_manual_mode
bool

Whether schedule live is in manual mode, in which live video will start manually instead of on schedled time

is_reference_only
bool

Whether the live video is exclusively used for copyright monitoring

live_views
unsigned int32

The instant viewer count of the live video now

overlay_url
string

A URL used in conjunction with Facebook Live Producer to show overlays for this broadcast. In order to use this, the page hosting the broadcast needs to be whitelisted.

permalink_url
uri

The permalink URL of this video on Facebook.

planned_start_time
datetime

Planned start time for a live video

recommended_encoder_settings
LiveVideoRecommendedEncoderSettings

Recommended encoder settings for this live video.

seconds_left
int32

Seconds left in the maximum possible duration for this live video

secure_stream_url
string

The secure stream url of the live video. Check with your encoder whether this is supported before adapting

기본
status
enum

The status of the LiveVideo.

A LIVE_NOW LiveVideo is one that will be published to the intended destination (Timeline, Group, Page, etc) upon receiving valid video data, or one that is already published and actively streaming.

An UNPUBLISHED LiveVideo is in preparation; it's not visible to other users, and it may be automatically deleted after several hours in this state.

A SCHEDULED_UNPUBLISHED LiveVideo is scheduled to go live at a future time.

A SCHEDULED_LIVE LiveVideo is one whose scheduled time has passed, yet the stream is not yet live. Either in the process of transitioning, or still waiting for a valid video stream.

(Consider using the SCHEDULED states to create a planned, future LiveVideo.)

기본
stream_url
string

The stream url of the live video

기본
targeting
LiveVideoTargeting

Targeting information for this live video

title
string

The title of the live video

기본
video
Video

The inside video of the live video

에지

Edge설명
blocked_users
Edge<User>

The users who are blocked from commenting on the live video

comments
Edge<Comment>

Comments made on this

crosspost_shared_pages
Edge<Page>

Pages which are allowed to crosspost this live video. This field is only available on the original live video.

crossposted_broadcasts
Edge<LiveVideo>

Live videos which have been crossposted from this live video. This field is only available on the original live video.

errors
Edge<LiveVideoError>

Errors that occurred during the live stream

polls
Edge<VideoPoll>

Polls configured for this broadcast

reactions
Edge<Profile>

People who reacted on this

오류 코드

오류설명
100Invalid parameter
190Invalid OAuth 2.0 Access Token
200Permissions error
104Incorrect signature
102Session key invalid or no longer valid

만들기

다음 경로에서 live_videos 에지에 POST 요청을 만들 수 있습니다:
이 에지에 게시할 때 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
                    ~~~~

description
UTF-8 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

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.

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.

title
UTF-8 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,
}

오류 코드

오류설명
200Permissions error
368The action attempted has been deemed abusive or is otherwise disallowed
100Invalid parameter
190Invalid OAuth 2.0 Access Token
102Session key invalid or no longer valid
1000Invalid time for an event.
1005Fail to upload cover photo.
다음 경로에서 live_videos 에지에 POST 요청을 만들 수 있습니다:
이 에지에 게시할 때 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
                                ~~~~

description
UTF-8 string

The description of 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

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.

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.

title
UTF-8 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,
}

오류 코드

오류설명
6000There was a problem uploading your video file. Please try again with another file.
다음 경로에서 live_videos 에지에 POST 요청을 만들 수 있습니다:
이 에지에 게시할 때 a LiveVideo이(가) 생성됩니다.

매개변수

매개변수설명
content_tags
list<numeric string>

Tags that describe the contents of the Live Video. Use search endpoint with type=adinterest to get possible IDs. For example: /search?type=adinterest&q=couscous

description
UTF-8 string

The description of 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. Currently only used for live-360 broadcasts. The value should be the identifier key of the encoding settings preset. Encoding presets can be found by querying the GET /broadcaster_encoding_settings endpoint

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

is_spherical
boolean

Denotes if 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

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. Set 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}

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

title
UTF-8 string

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,
}

오류 코드

오류설명
100Invalid parameter
200Permissions error
190Invalid OAuth 2.0 Access Token
다음 경로에서 live_videos 에지에 POST 요청을 만들 수 있습니다:
이 에지에 게시할 때 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
page ID

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
UTF-8 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
UTF-8 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,
}

오류 코드

오류설명
200Permissions error
368The action attempted has been deemed abusive or is otherwise disallowed
100Invalid parameter
1000Invalid time for an event.
190Invalid OAuth 2.0 Access Token
1005Fail to upload cover photo.
102Session key invalid or no longer valid

업데이트 중

/{live_video_id}에 POST 요청을 하여 a LiveVideo을(를) 업데이트할 수 있습니다.

매개변수

매개변수설명
allow_bm_crossposting
boolean

If set to true, makes this live video available for crossposting by Pages in your Business Manager.

content_tags
list<numeric string>

Tags that describe the contents of the video. Use search endpoint with type=adinterest to get possible IDs. For example, /search?type=adinterest&q=couscous.

cross_share_to_group_ids
list<numeric string>

List of Groups by ID where the broadcast will be shared. The broadcast owner will require publishing permission to the groups in order to share.

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](https://www.facebook.com/help/publisher/1385580858214929) 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

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
UTF-8 string

The description of live video

이모티콘 지원
direct_share_status
int64

The status to allow sponsor directly boost the post.

disturbing
boolean

If true, autoplay will be disabled and live video will have a graphic content warning overlay

donate_button_charity_id
int64

Specifies the ID of the charity for which a donate button will be added to the live video. If zero is passed, will remove the donate button on the video.

embeddable
boolean

If true, live video will be embeddable

end_live_video
boolean

If true, the live video will be ended. Only valid if the live video is still running

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', }

is_manual_mode
boolean

Flag to indicate that the scheduled broadcast is switched to manual mode

live_comment_moderation_setting
list<enum {DEFAULT, FOLLOWER, SLOW, DISCUSSION, RESTRICTED, PROTECTED_MODE, SUPPORTER, NO_HYPERLINK, FOLLOWED, TAGGED}>

Set of comment moderation settings for the live video

master_ingest_stream_id
numeric string

Ingest stream to set to master and route viewers to.

persistent_stream_key_status
enum {ENABLE, DISABLE, REGENERATE}

Set the status of the persistent stream key for this live video

place
place tag

Location associated with the video, if any.

planned_start_time
datetime/timestamp

Planned start time for a scheduled live video

privacy
Privacy Parameter

The privacy setting of live video

published
boolean

Should the live video be published? Only valid if not yet published.

        Deprecated. Prefer setting the status instead.

schedule_custom_profile_image
image

Custom image that will appear in the scheduled live story and lobby.

schedule_feed_background_image
image

Custom background image that appears in the updated scheduled live story

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

status
enum {UNPUBLISHED, LIVE_NOW, SCHEDULED_UNPUBLISHED, SCHEDULED_LIVE, SCHEDULED_CANCELED}

The status of the LiveVideo.

A LIVE_NOW LiveVideo is one that will be published to the intended destination (Timeline, Group, Page, etc) upon receiving valid video data, or one that is already published and actively streaming.

An UNPUBLISHED LiveVideo is in preparation; it's not visible to other users, and it may be automatically deleted after several hours in this state.

A SCHEDULED_UNPUBLISHED LiveVideo is scheduled to go live at a future time.

A SCHEDULED_LIVE LiveVideo is one whose scheduled time has passed, yet the stream is not yet live. Either in the process of transitioning, or still waiting for a valid video stream.

(Consider using the SCHEDULED states to create a planned, future LiveVideo.)

tags
list<int>

Users tagged in the live video.

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
UTF-8 string

The title of the live video.

이모티콘 지원

반환 유형

이 엔드포인트는 기록 후 읽기를 지원하며 반환 유형에서 id로 표시되는 노드를 읽습니다.
Struct {
id: numeric string,
persistent_stream_url: string,
backup_persistent_stream_url: string,
}

오류 코드

오류설명
100Invalid parameter
200Permissions error
190Invalid OAuth 2.0 Access Token
1005Fail to upload cover photo.
102Session key invalid or no longer valid
104Incorrect signature

삭제 중

/{live_video_id}에 DELETE 요청을 만들어 a LiveVideo을(를) 삭제할 수 있습니다.

Limitations

You cannot delete a LiveVideo on a User or Group.

매개변수

이 엔드포인트는 매개변수가 없습니다.

반환 유형

Struct {
success: bool,
}

오류 코드

오류설명
100Invalid parameter