Ad Videos

읽기

이 엔드포인트에서 수행할 수 없는 작업입니다.

만들기

다음 경로에서 advideos 에지에 POST 요청을 만들 수 있습니다:

/act_{ad_account_id}/advideos

이 에지에 게시할 때 a Video이(가) 생성됩니다.

매개변수

매개변수	설명
`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 이모티콘 지원
`end_offset` int64	end_offset
`file_size` 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
`original_projection_type` enum {equirectangular, cubemap, half_equirectangular}	Original Projection type of the video being uploaded
`prompt_id` string	SELF_EXPLANATORY
`prompt_tracking_string` string	SELF_EXPLANATORY
`referenced_sticker_id` numeric string or integer	SELF_EXPLANATORY
`slideshow_spec` JSON object	An object required for slideshow video.
`images_urls` list<URL>	A 3-7 element array of the URLs of the images. Required. 필수
`duration_ms` integer	The duration in milliseconds of each image. Default value is 1000.
`transition_ms` integer	The duration in milliseconds of the crossfade transition between images. Default value is 1000.
`reordering_opt_in` boolean	기본 값: `false`
`music_variations_opt_in` boolean	기본 값: `false`
`source` string	The video, encoded as form data. See the Video Format doc for more details on video formats.
`start_offset` 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. 이모티콘 지원
`transcode_setting_properties` 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
`upload_phase` enum {start, transfer, finish, cancel}	The phase during chunked upload. Using during chunked upload.
`upload_session_id` numeric string or integer	The session ID of this chunked upload. Using during chunked upload.
`video_file_chunk` string	The chunk of the video, between `start_offset` and `end_offset`. Using during chunked upload.

반환 유형

Struct {

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,

}

오류 코드

오류	설명
100	Invalid parameter
389	Unable to fetch video file from URL.
382	The video file you tried to upload is too small. Please try again with a larger file.
368	The action attempted has been deemed abusive or is otherwise disallowed
222	Video not visible
390	There was a problem uploading your video file. Please try again.
351	There was a problem with your video file. Please try again with another file,
190	Invalid OAuth 2.0 Access Token
200	Permissions error

업데이트 중

이 엔드포인트에서 수행할 수 없는 작업입니다.

삭제 중

/act_{ad_account_id}/advideos에 DELETE 요청을 만들어 an AdAccount에서 a Video을(를) 분리할 수 있습니다.

매개변수

매개변수 설명

매개변수	설명
`video_id` video ID	Ad account library video ID 필수

video_id

video ID

Ad account library video ID

필수

반환 유형

Struct {

success: bool,

}

오류 코드

오류	설명
100	Invalid parameter
613	Calls to this api have exceeded the rate limit.
368	The action attempted has been deemed abusive or is otherwise disallowed