상품 동영상의 필드에는 별도 동영상 API를 통해 업로드 & 인코딩된 동영상의 id, 동영상의 대표 썸네일, 상세 페이지 노출 여부 필드가 포함됩니다.
주의사항
별도 동영상 업로드 API를 통해 반환된 vid와 인코딩이 완료된 동영상을 입력해야 합니다.
필드 제약사항
# 서로 다른 상품에 동일한 동영상 사용 여부 - 동영상의 중복은 허용되지 않습니다. 중복 vid가 입력되는 경우 에러가 발생합니다. # 상품 추가 이미지 갯수 제한 - 상품 동영상은 추가 이미지 4개 이하인 경우에만 등록 가능합니다.
수정 시 주의사항
# 동영상 정보를 수정하지 않는 경우에는, 조회된 vid, thmbnailUrl, exposeDetail 정보를 다시 그대로 넣어서 요청해야합니다.
상품등록시 샘플
{ "vid": "rvfmt81n1cp3d46f123456789", "thumbnailUrl": "https://thumb.kakaocdn.net/dna/kamp/~", "exposeDetail": true }
상품 수정시 동영상 수정이 없는 경우 샘플
상품 등록후에 상품을 조회하면 동영상 마다 id가 부여됩니다. 수정하지 않을 경우는 조회된 동영상 정보 그대로 설정합니다.
{ "vid": "rvfmt81n1cp3d46f123456789", "thumbnailUrl": "https://thumb.kakaocdn.net/dna/kamp/~", "exposeDetail": true }
상품수정시 이미지를 삭제하는 경우
productVideo 필드를 null로 설정하면 상품에 설정되어 있는 동영상 정보를 삭제합니다.
필드 상세
필드명 | 타입 | 필수여부 | 설명 |
---|---|---|---|
vid | String | 필수 | 업로드된 동영상 id |
thumbnailUrl | String | 필수 | 동영상 대표 썸네일 |
exposeDetail | Boolean | 필수 | 상품 상세 페이지에 동영상 노출 여부 |