> For the complete documentation index, see [llms.txt](https://help.genser.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genser.ai/developers/product-collection/api.md).
# 상품 데이터 수집 API
## 상품 수집
> 상품 데이터를 수집합니다.
```json
{"openapi":"3.0.3","info":{"title":"통합 데이터 수집 API (기본)","version":"1.0.0"},"tags":[{"name":"상품 데이터 수집 API"}],"servers":[{"url":"https://api.gelatto.ai","description":"Production"}],"paths":{"/collector/products":{"post":{"summary":"상품 수집","description":"상품 데이터를 수집합니다.","tags":["상품 데이터 수집 API"],"parameters":[{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string","enum":["application/json"]},"description":"컨텐츠 타입"},{"name":"Api-Key","in":"header","required":true,"schema":{"type":"string"},"description":"API 키"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectorProductsPostEvent"}}}},"responses":{"200":{"description":"수집 성공"},"400":{"description":"잘못된 요청"},"503":{"description":"서비스 일시 불가"}}}}},"components":{"schemas":{"CollectorProductsPostEvent":{"title":"고객사 상품수집 - 상품 등록","description":"고객사의 상품 데이터 수집","type":"object","required":["agent","@graph"],"properties":{"@context":{"type":"string","description":"스키마 context","enum":["https://schema.org"]},"specversion":{"type":"string","description":"스펙 버전","enum":[1]},"id":{"type":"string","description":"이벤트 고유 식별자","enum":["EVT-CREATE-PRODUCT"]},"type":{"type":"string","description":"상품 수집 유형","enum":["create_product"]},"agent":{"type":"object","description":"요청 기업 정보","required":["name"],"properties":{"@type":{"type":"string","description":"유형","enum":["Organization"]},"name":{"type":"string","description":"데이터를 요청한 기업명"}}},"@graph":{"items":{"type":"object","required":["sku","name","description","brand","category","url","offers"],"properties":{"@type":{"type":"string","description":"유형","enum":["Product"]},"sku":{"type":"string","description":"상품 관리 코드(SKU)"},"name":{"description":"상품명","oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsLangName"}},{"$ref":"#/components/schemas/CollectorProductsLangName"},{"type":"string"}]},"description":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsDescription"}},{"$ref":"#/components/schemas/CollectorProductsDescription"}]},"brand":{"type":"object","description":"브랜드 관련 정보","required":["@id","name"],"properties":{"@type":{"type":"string","description":"유형","enum":["Brand"]},"@id":{"type":"string","description":"브랜드 식별 코드"},"name":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsBrandName"}},{"$ref":"#/components/schemas/CollectorProductsBrandName"},{"description":"상품명","type":"string"}]},"logo":{"items":{"type":"string","description":"브랜드 로고 이미지 URL"},"type":"array","description":"브랜드 로고 이미지 URL"}}},"category":{"description":"상품 카테고리 정보","oneOf":[{"description":"상품 카테고리 정보","type":"array","items":{"$ref":"#/components/schemas/CollectorProductsCategory"}},{"$ref":"#/components/schemas/CollectorProductsCategory"}]},"positiveNotes":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsPositiveNote"}},{"$ref":"#/components/schemas/CollectorProductsPositiveNote"},{"description":"상품의 주요 특징 및 장점","type":"array","items":{"type":"string"}},{"description":"상품의 주요 특징 및 장점","type":"string"}]},"url":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsUrl"}},{"$ref":"#/components/schemas/CollectorProductsUrl"},{"description":"상품 상세 페이지 URL","type":"array","items":{"type":"string"}},{"description":"상품 상세 페이지 URL","type":"string"}]},"mobileUrl":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsMobileUrl"}},{"$ref":"#/components/schemas/CollectorProductsMobileUrl"},{"description":"모바일 상품 상세 페이지 URL","type":"array","items":{"type":"string"}},{"description":"모바일 상품 상세 페이지 URL","type":"string"}]},"itemCondition":{"type":"string","description":"상품 상태","enum":["NewCondition","RefurbishedCondition","UsedCondition","DamagedCondition"]},"hasAdultConsideration":{"type":"string","description":"성인 대상 상품","enum":["AlcoholConsideration","DangerousGoodConsideration","HealthcareConsideration","NarcoticConsideration","ReducedRelevanceForChildrenConsideration","SexualContentConsideration","TobaccoNicotineConsideration","UnclassifiedAdultConsideration","ViolenceConsideration","WeaponConsideration"]},"countryOfOrigin":{"type":"object","description":"제조 국가 정보","required":["address"],"properties":{"@type":{"type":"string","description":"유형","enum":["Country"]},"address":{"type":"string","description":"제조 국가 코드 (ISO 3166-1-alpha-2)"}}},"material":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsMaterial"}},{"$ref":"#/components/schemas/CollectorProductsMaterial"},{"description":"상품 소재 정보","type":"array","items":{"type":"string"}},{"description":"상품 소재 정보","type":"string"}]},"additionalProperty":{"items":{"type":"object","properties":{"@type":{"type":"string","description":"유형","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"추가 속성 식별값"},"value":{"description":"속성 값"}}},"type":"array","description":"추가 속성 정보","minItems":1},"offers":{"oneOf":[{"$ref":"#/components/schemas/CollectorProductsOffers"},{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsOffers"}}]}}},"type":"array","description":"상품 데이터","minItems":1,"maxItems":1000}}},"CollectorProductsLangName":{"type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"실제 입력 값"},"@language":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]}}},"CollectorProductsDescription":{"description":"상품 상세 설명 정보","type":"object","required":["text","inLanguage"],"properties":{"@type":{"type":"string","description":"유형","enum":["TextObject"]},"text":{"type":"string","description":"상품 상세 설명 (텍스트)"},"inLanguage":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]},"image":{"description":"상품 상세 설명 (이미지)
상품 상세 설명이 이미지일 경우에만 사용","oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsDescriptionImage"}},{"$ref":"#/components/schemas/CollectorProductsDescriptionImage"}]},"additionalProperty":{"items":{"type":"object","properties":{"@type":{"type":"string","description":"유형","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"추가 속성 식별값"},"value":{"description":"속성 값"}}},"type":"array","description":"추가 속성 정보","minItems":1}}},"CollectorProductsDescriptionImage":{"description":"상품 상세 설명 (이미지)","type":"object","properties":{"@type":{"type":"string","description":"유형","enum":["ImageObject"]},"contentUrl":{"type":"string","description":"상품 상세 설명 이미지 파일 URL"},"inLanguage":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]}}},"CollectorProductsBrandName":{"description":"브랜드명","type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"실제 입력 값"},"@language":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]}}},"CollectorProductsCategory":{"type":"object","required":["codeValue","name","position"],"properties":{"@type":{"type":"string","description":"유형","enum":["CategoryCode"]},"codeValue":{"type":"string","description":"카테고리 식별 코드"},"name":{"description":"카테고리명","oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsCategoryName"}},{"$ref":"#/components/schemas/CollectorProductsCategoryName"}]},"position":{"type":"integer","description":"카테고리 계층 레벨"}}},"CollectorProductsCategoryName":{"type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"실제 입력 값"},"@language":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]}}},"CollectorProductsPositiveNote":{"description":"상품의 주요 특징 및 장점 요약","type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"실제 입력 값"},"@language":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]}}},"CollectorProductsUrl":{"description":"상품 상세 페이지 URL","type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"실제 입력 값"},"@language":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]}}},"CollectorProductsMobileUrl":{"description":"모바일 상품 상세 페이지 URL","type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"실제 입력 값"},"@language":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]}}},"CollectorProductsMaterial":{"description":"상품 소재 정보","type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"실제 입력 값"},"@language":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]}}},"CollectorProductsOffers":{"description":"SKU 별 가격, 판매 가능 여부","type":"object","required":["sku","mpn","price","priceCurrency","color","size","availability","availabilityStarts","availabilityEnds","image"],"properties":{"@type":{"type":"string","description":"유형","enum":["Offer"]},"sku":{"type":"string","description":"상품 관리 코드(SKU)"},"gtin":{"type":"string","description":"국제 표준 상품 바코드 번호"},"mpn":{"type":"string","description":"제조사 관리 번호(MPN)"},"price":{"type":"number","description":"판매 가격"},"priceCurrency":{"type":"string","description":"ISO 4217 통화코드"},"priceSpecification":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsPriceSpecification"}},{"$ref":"#/components/schemas/CollectorProductsPriceSpecification"}]},"color":{"type":"string","description":"색상"},"size":{"type":"string","description":"사이즈"},"availability":{"type":"string","description":"재고 상태","enum":["BackOrder","Discontinued","InStock","InStoreOnly","LimitedAvailability","MadeToOrder","OnlineOnly","OutOfStock","PreOrder","PreSale","Reserved","SoldOut"]},"availabilityStarts":{"type":"string","description":"판매 시작 일시 (UTC ISO8601)"},"availabilityEnds":{"type":"string","description":"판매 종료 일시 (UTC ISO8601)"},"inventoryLevel":{"type":"object","description":"재고 현황 정보","required":["value"],"properties":{"@type":{"type":"string","description":"유형","enum":["QuantitativeValue"]},"value":{"type":"number","description":"속성 값"}}},"shippingDetails":{"type":"object","description":"배송 정보","required":["weight"],"properties":{"@type":{"type":"string","description":"유형","enum":["OfferShippingDetails"]},"weight":{"type":"object","description":"배송 기준 무게","required":["value","unitCode"],"properties":{"@type":{"type":"string","description":"유형","enum":["QuantitativeValue"]},"value":{"type":"number","description":"속성 값"},"unitCode":{"type":"string","description":"배송 무게 표시 단위"}}}}},"image":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsImage"}},{"$ref":"#/components/schemas/CollectorProductsImage"}]},"additionalProperty":{"items":{"type":"object","properties":{"@type":{"type":"string","description":"유형","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"추가 속성 식별값"},"value":{"description":"속성 값"}}},"type":"array","description":"추가 속성 정보","minItems":1}}},"CollectorProductsPriceSpecification":{"description":"가격 유형","type":"object","required":["priceType","price","priceCurrency","unitCode"],"properties":{"@type":{"type":"string","description":"유형","enum":["UnitPriceSpecification"]},"priceType":{"type":"string","description":"가격 구분","enum":["InvoicePrice","ListPrice","MSRP","MinimumAdvertisedPrice","RegularPrice","SRP","SalePrice","StrikethroughPrice"]},"price":{"type":"number","description":"가격"},"priceCurrency":{"type":"string","description":"ISO 4217 통화코드"},"unitCode":{"type":"string","description":"단위 코드"}}},"CollectorProductsImage":{"description":"상품 이미지 정보","type":"object","required":["contentUrl"],"properties":{"@type":{"type":"string","description":"유형","enum":["ImageObject"]},"representativeOfPage":{"type":"boolean","description":"대표 이미지 여부"},"contentUrl":{"type":"string","description":"이미지 파일 URL"},"contentSize":{"type":"string","description":"이미지 파일 사이즈"},"width":{"type":"object","description":"이미지 넓이","properties":{"@type":{"type":"string","description":"유형","enum":["QuantitativeValue"]},"value":{"type":"number","description":"속성 값"}}},"height":{"type":"object","description":"이미지 높이","properties":{"@type":{"type":"string","description":"유형","enum":["QuantitativeValue"]},"value":{"type":"number","description":"속성 값"}}}}}}}}
```
## 상품 수정
> 상품 데이터를 수정합니다.
```json
{"openapi":"3.0.3","info":{"title":"통합 데이터 수집 API (기본)","version":"1.0.0"},"tags":[{"name":"상품 데이터 수집 API"}],"servers":[{"url":"https://api.gelatto.ai","description":"Production"}],"paths":{"/collector/products":{"put":{"summary":"상품 수정","description":"상품 데이터를 수정합니다.","tags":["상품 데이터 수집 API"],"parameters":[{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string","enum":["application/json"]},"description":"컨텐츠 타입"},{"name":"Api-Key","in":"header","required":true,"schema":{"type":"string"},"description":"API 키"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectorProductsPutEvent"}}}},"responses":{"200":{"description":"수집 성공"},"400":{"description":"잘못된 요청"},"503":{"description":"서비스 일시 불가"}}}}},"components":{"schemas":{"CollectorProductsPutEvent":{"title":"고객사 상품수집 - 상품 등록","description":"고객사의 상품 데이터 수집","type":"object","required":["agent","@graph"],"properties":{"@context":{"type":"string","description":"스키마 context","enum":["https://schema.org"]},"specversion":{"type":"string","description":"스펙 버전","enum":[1]},"id":{"type":"string","description":"이벤트 고유 식별자","enum":["EVT-UPDATE-PRODUCT"]},"type":{"type":"string","description":"상품 수집 유형","enum":["update_product"]},"agent":{"type":"object","description":"요청 기업 정보","required":["name"],"properties":{"@type":{"type":"string","description":"유형","enum":["Organization"]},"name":{"type":"string","description":"데이터를 요청한 기업명"}}},"@graph":{"items":{"type":"object","required":["sku","name","description","brand","category","url","offers"],"properties":{"@type":{"type":"string","description":"유형","enum":["Product"]},"sku":{"type":"string","description":"상품 관리 코드(SKU)"},"name":{"description":"상품명","oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsLangName"}},{"$ref":"#/components/schemas/CollectorProductsLangName"},{"type":"string"}]},"description":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsDescription"}},{"$ref":"#/components/schemas/CollectorProductsDescription"}]},"brand":{"type":"object","description":"브랜드 관련 정보","required":["@id","name"],"properties":{"@type":{"type":"string","description":"유형","enum":["Brand"]},"@id":{"type":"string","description":"브랜드 식별 코드"},"name":{"oneOf":[{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/CollectorProductsBrandName"},{"type":"string"}]}},{"$ref":"#/components/schemas/CollectorProductsBrandName"},{"description":"상품명","type":"string"}]},"logo":{"items":{"type":"string","description":"브랜드 로고 이미지 URL"},"type":"array","description":"브랜드 로고 이미지 URL"}}},"category":{"description":"상품 카테고리 정보","oneOf":[{"description":"상품 카테고리 정보","type":"array","items":{"$ref":"#/components/schemas/CollectorProductsCategory"}},{"$ref":"#/components/schemas/CollectorProductsCategory"}]},"positiveNotes":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsPositiveNote"}},{"$ref":"#/components/schemas/CollectorProductsPositiveNote"},{"description":"상품의 주요 특징 및 장점","type":"array","items":{"type":"string"}},{"description":"상품의 주요 특징 및 장점","type":"string"}]},"url":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsUrl"}},{"$ref":"#/components/schemas/CollectorProductsUrl"},{"description":"상품 상세 페이지 URL","type":"array","items":{"type":"string"}},{"description":"상품 상세 페이지 URL","type":"string"}]},"mobileUrl":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsMobileUrl"}},{"$ref":"#/components/schemas/CollectorProductsMobileUrl"},{"description":"모바일 상품 상세 페이지 URL","type":"array","items":{"type":"string"}},{"description":"모바일 상품 상세 페이지 URL","type":"string"}]},"itemCondition":{"type":"string","description":"상품 상태","enum":["NewCondition","RefurbishedCondition","UsedCondition","DamagedCondition"]},"hasAdultConsideration":{"type":"string","description":"성인 대상 상품","enum":["AlcoholConsideration","DangerousGoodConsideration","HealthcareConsideration","NarcoticConsideration","ReducedRelevanceForChildrenConsideration","SexualContentConsideration","TobaccoNicotineConsideration","UnclassifiedAdultConsideration","ViolenceConsideration","WeaponConsideration"]},"countryOfOrigin":{"type":"object","description":"제조 국가 정보","required":["address"],"properties":{"@type":{"type":"string","description":"유형","enum":["Country"]},"address":{"type":"string","description":"제조 국가 코드 (ISO 3166-1-alpha-2)"}}},"material":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsMaterial"}},{"$ref":"#/components/schemas/CollectorProductsMaterial"},{"description":"상품 소재 정보","type":"array","items":{"type":"string"}},{"description":"상품 소재 정보","type":"string"}]},"additionalProperty":{"items":{"type":"object","properties":{"@type":{"type":"string","description":"유형","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"추가 속성 식별값"},"value":{"description":"속성 값"}}},"type":"array","description":"추가 속성 정보","minItems":1},"offers":{"oneOf":[{"$ref":"#/components/schemas/CollectorProductsOffers"},{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsOffers"}}]}}},"type":"array","description":"상품 데이터","minItems":1,"maxItems":1000}}},"CollectorProductsLangName":{"type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"실제 입력 값"},"@language":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]}}},"CollectorProductsDescription":{"description":"상품 상세 설명 정보","type":"object","required":["text","inLanguage"],"properties":{"@type":{"type":"string","description":"유형","enum":["TextObject"]},"text":{"type":"string","description":"상품 상세 설명 (텍스트)"},"inLanguage":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]},"image":{"description":"상품 상세 설명 (이미지)
상품 상세 설명이 이미지일 경우에만 사용","oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsDescriptionImage"}},{"$ref":"#/components/schemas/CollectorProductsDescriptionImage"}]},"additionalProperty":{"items":{"type":"object","properties":{"@type":{"type":"string","description":"유형","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"추가 속성 식별값"},"value":{"description":"속성 값"}}},"type":"array","description":"추가 속성 정보","minItems":1}}},"CollectorProductsDescriptionImage":{"description":"상품 상세 설명 (이미지)","type":"object","properties":{"@type":{"type":"string","description":"유형","enum":["ImageObject"]},"contentUrl":{"type":"string","description":"상품 상세 설명 이미지 파일 URL"},"inLanguage":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]}}},"CollectorProductsBrandName":{"description":"브랜드명","type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"실제 입력 값"},"@language":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]}}},"CollectorProductsCategory":{"type":"object","required":["codeValue","name","position"],"properties":{"@type":{"type":"string","description":"유형","enum":["CategoryCode"]},"codeValue":{"type":"string","description":"카테고리 식별 코드"},"name":{"description":"카테고리명","oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsCategoryName"}},{"$ref":"#/components/schemas/CollectorProductsCategoryName"}]},"position":{"type":"integer","description":"카테고리 계층 레벨"}}},"CollectorProductsCategoryName":{"type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"실제 입력 값"},"@language":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]}}},"CollectorProductsPositiveNote":{"description":"상품의 주요 특징 및 장점 요약","type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"실제 입력 값"},"@language":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]}}},"CollectorProductsUrl":{"description":"상품 상세 페이지 URL","type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"실제 입력 값"},"@language":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]}}},"CollectorProductsMobileUrl":{"description":"모바일 상품 상세 페이지 URL","type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"실제 입력 값"},"@language":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]}}},"CollectorProductsMaterial":{"description":"상품 소재 정보","type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"실제 입력 값"},"@language":{"type":"string","description":"ISO 639-1 언어코드","enum":["ko","en","ja"]}}},"CollectorProductsOffers":{"description":"SKU 별 가격, 판매 가능 여부","type":"object","required":["sku","mpn","price","priceCurrency","color","size","availability","availabilityStarts","availabilityEnds","image"],"properties":{"@type":{"type":"string","description":"유형","enum":["Offer"]},"sku":{"type":"string","description":"상품 관리 코드(SKU)"},"gtin":{"type":"string","description":"국제 표준 상품 바코드 번호"},"mpn":{"type":"string","description":"제조사 관리 번호(MPN)"},"price":{"type":"number","description":"판매 가격"},"priceCurrency":{"type":"string","description":"ISO 4217 통화코드"},"priceSpecification":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsPriceSpecification"}},{"$ref":"#/components/schemas/CollectorProductsPriceSpecification"}]},"color":{"type":"string","description":"색상"},"size":{"type":"string","description":"사이즈"},"availability":{"type":"string","description":"재고 상태","enum":["BackOrder","Discontinued","InStock","InStoreOnly","LimitedAvailability","MadeToOrder","OnlineOnly","OutOfStock","PreOrder","PreSale","Reserved","SoldOut"]},"availabilityStarts":{"type":"string","description":"판매 시작 일시 (UTC ISO8601)"},"availabilityEnds":{"type":"string","description":"판매 종료 일시 (UTC ISO8601)"},"inventoryLevel":{"type":"object","description":"재고 현황 정보","required":["value"],"properties":{"@type":{"type":"string","description":"유형","enum":["QuantitativeValue"]},"value":{"type":"number","description":"속성 값"}}},"shippingDetails":{"type":"object","description":"배송 정보","required":["weight"],"properties":{"@type":{"type":"string","description":"유형","enum":["OfferShippingDetails"]},"weight":{"type":"object","description":"배송 기준 무게","required":["value","unitCode"],"properties":{"@type":{"type":"string","description":"유형","enum":["QuantitativeValue"]},"value":{"type":"number","description":"속성 값"},"unitCode":{"type":"string","description":"배송 무게 표시 단위"}}}}},"image":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsImage"}},{"$ref":"#/components/schemas/CollectorProductsImage"}]},"additionalProperty":{"items":{"type":"object","properties":{"@type":{"type":"string","description":"유형","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"추가 속성 식별값"},"value":{"description":"속성 값"}}},"type":"array","description":"추가 속성 정보","minItems":1}}},"CollectorProductsPriceSpecification":{"description":"가격 유형","type":"object","required":["priceType","price","priceCurrency","unitCode"],"properties":{"@type":{"type":"string","description":"유형","enum":["UnitPriceSpecification"]},"priceType":{"type":"string","description":"가격 구분","enum":["InvoicePrice","ListPrice","MSRP","MinimumAdvertisedPrice","RegularPrice","SRP","SalePrice","StrikethroughPrice"]},"price":{"type":"number","description":"가격"},"priceCurrency":{"type":"string","description":"ISO 4217 통화코드"},"unitCode":{"type":"string","description":"단위 코드"}}},"CollectorProductsImage":{"description":"상품 이미지 정보","type":"object","required":["contentUrl"],"properties":{"@type":{"type":"string","description":"유형","enum":["ImageObject"]},"representativeOfPage":{"type":"boolean","description":"대표 이미지 여부"},"contentUrl":{"type":"string","description":"이미지 파일 URL"},"contentSize":{"type":"string","description":"이미지 파일 사이즈"},"width":{"type":"object","description":"이미지 넓이","properties":{"@type":{"type":"string","description":"유형","enum":["QuantitativeValue"]},"value":{"type":"number","description":"속성 값"}}},"height":{"type":"object","description":"이미지 높이","properties":{"@type":{"type":"string","description":"유형","enum":["QuantitativeValue"]},"value":{"type":"number","description":"속성 값"}}}}}}}}
```
## 상품 삭제
> 상품 데이터 삭제 요청합니다.
```json
{"openapi":"3.0.3","info":{"title":"통합 데이터 수집 API (기본)","version":"1.0.0"},"tags":[{"name":"상품 데이터 수집 API"}],"servers":[{"url":"https://api.gelatto.ai","description":"Production"}],"paths":{"/collector/products-delete":{"put":{"summary":"상품 삭제","description":"상품 데이터 삭제 요청합니다.","tags":["상품 데이터 수집 API"],"parameters":[{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string","enum":["application/json"]},"description":"컨텐츠 타입"},{"name":"Api-Key","in":"header","required":true,"schema":{"type":"string"},"description":"API 키"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollectorProductsDeleteEvent"}}}},"responses":{"200":{"description":"수집 성공"},"400":{"description":"잘못된 요청"},"503":{"description":"서비스 일시 불가"}}}}},"components":{"schemas":{"CollectorProductsDeleteEvent":{"title":"고객사 상품수집 - 상품 삭제","description":"고객사의 상품 데이터 삭제 요청 수집","type":"object","required":["@graph"],"properties":{"@context":{"type":"string","description":"스키마 context","enum":["https://schema.org"]},"specversion":{"type":"string","description":"스펙 버전","enum":[1]},"id":{"type":"string","description":"이벤트 고유 식별자","enum":["EVT-DELETE-PRODUCT"]},"type":{"type":"string","description":"상품 수집 유형","enum":["delete_product"]},"agent":{"type":"object","description":"요청 기업 정보","required":["name"],"properties":{"@type":{"type":"string","description":"유형","enum":["Organization"]},"name":{"type":"string","description":"데이터를 요청한 기업명"}}},"@graph":{"items":{"type":"object","required":["sku"],"properties":{"@type":{"type":"string","description":"유형","enum":["Product"]},"sku":{"type":"string","description":"상품 관리 코드(SKU)"}}},"type":"array","description":"상품 데이터","minItems":1,"maxItems":1000}}}}}}
```