Skip to main content
PATCH
소재 수정

인증

Authorization
string
header
필수

Bearer 인증. 액세스 토큰을 Authorization: Bearer <token> 헤더로 전달합니다.

경로 매개변수

crid
string<uuid>
필수

본문

application/json

PATCH 시 모든 필드는 선택입니다.

advertiser_domain
string | null
advertiser_id
string<uuid> | null
banner
BannerInput · object | null

쓰기/입력용 DTO — write 시점에만 URL 스킴을 검증한다.

description
string | null
end_date
string<date-time> | null
ext
any
height
integer | null
필수 범위: x >= 0
name
string | null
native
NativeInput · object | null

쓰기/입력용 DTO — write 시점에만 URL 스킴을 검증한다.

start_date
string<date-time> | null
status
enum<string> | null
사용 가능한 옵션:
inactive,
active
type
enum<string> | null
사용 가능한 옵션:
banner,
video,
native
video
Video · object | null
width
integer | null
필수 범위: x >= 0

응답

성공 응답

created_at
string<date-time>
필수
height
integer
필수

소재 높이 (픽셀).

필수 범위: x >= 0
id
string<uuid>
필수

소재 고유 식별자 (UUID v7).

name
string
필수

소재 이름.

owner_id
string<uuid>
필수

소재를 생성한 관리자/운영자 사용자 ID.

type
enum<string>
필수

소재 유형 (예: "banner", "video", "native").

사용 가능한 옵션:
banner,
video,
native
updated_at
string<date-time>
필수
width
integer
필수

소재 너비 (픽셀).

필수 범위: x >= 0
advertiser_domain
string | null

이 소재를 사용하는 광고주 도메인.

advertiser_id
string<uuid> | null

이 소재를 사용하는 광고주 ID.

banner
BannerResponse · object | null

읽기/응답용 DTO — 저장된 AdCOM Banner를 그대로 노출. 검증 없음.

description
string | null

소재의 선택적 설명.

end_date
string<date-time> | null
ext
any
기본값:{}

소재 확장 데이터

native
Native · object | null

네이티브 소재 콘텐츠.

no
integer | null
start_date
string<date-time> | null
status
enum<string>
기본값:inactive

소재 상태.

사용 가능한 옵션:
inactive,
active
video
Video · object | null