> 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/ja/developers/product-collection/dtaapi.md).
# 商品データ収集API
## 商品登録
> 商品データ収集API
```json
{"openapi":"3.0.3","info":{"title":"商品データ収集API","version":"1.0.0"},"tags":[{"name":"商品データ収集API"}],"servers":[{"url":"https://api.gelatto.jp","description":"Production"}],"paths":{"/collector/products":{"post":{"summary":"商品登録","description":"商品データ収集API","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.0"]},"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":{"type":"array","description":"商品データ","minItems":1,"maxItems":1000,"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"},{"type":"string","description":"商品名"}]},"logo":{"type":"array","description":"ブランドロゴ画像URL","items":{"type":"string","description":"ブランドロゴ画像URL"}}}},"category":{"description":"商品カテゴリ情報","oneOf":[{"type":"array","description":"商品カテゴリ情報","items":{"$ref":"#/components/schemas/CollectorProductsCategory"}},{"$ref":"#/components/schemas/CollectorProductsCategory"}]},"positiveNotes":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsPositiveNote"}},{"$ref":"#/components/schemas/CollectorProductsPositiveNote"},{"type":"array","description":"商品の主な特徴および利点","items":{"type":"string"}},{"type":"string","description":"商品の主な特徴および利点"}]},"url":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsUrl"}},{"$ref":"#/components/schemas/CollectorProductsUrl"},{"type":"array","description":"商品詳細ページURL","items":{"type":"string"}},{"type":"string","description":"商品詳細ページURL"}]},"mobileUrl":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsMobileUrl"}},{"$ref":"#/components/schemas/CollectorProductsMobileUrl"},{"type":"array","description":"モバイル商品詳細ページURL","items":{"type":"string"}},{"type":"string","description":"モバイル商品詳細ページURL"}]},"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"},{"type":"array","description":"商品素材情報","items":{"type":"string"}},{"type":"string","description":"商品素材情報"}]},"additionalProperty":{"type":"array","description":"追加属性情報","minItems":1,"items":{"type":"object","properties":{"@type":{"type":"string","description":"タイプ","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"追加属性識別値"},"value":{"description":"属性値"}}}},"offers":{"oneOf":[{"$ref":"#/components/schemas/CollectorProductsOffers"},{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsOffers"}}]}}}}}},"CollectorProductsLangName":{"type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"実際の入力値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}}},"CollectorProductsDescription":{"type":"object","description":"商品詳細説明情報","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":{"type":"array","description":"追加属性情報","minItems":1,"items":{"type":"object","properties":{"@type":{"type":"string","description":"タイプ","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"追加属性識別値"},"value":{"description":"属性値"}}}}}},"CollectorProductsDescriptionImage":{"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":{"type":"object","description":"ブランド名","properties":{"@value":{"type":"string","description":"実際の入力値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}},"required":["@value","@language"]},"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":{"type":"object","description":"商品の主な特徴および利点の要約","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"実際の入力値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}}},"CollectorProductsUrl":{"type":"object","description":"商品詳細ページURL","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"実際の入力値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}}},"CollectorProductsMobileUrl":{"type":"object","description":"モバイル商品詳細ページURL","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"実際の入力値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}}},"CollectorProductsMaterial":{"type":"object","description":"商品素材情報","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"実際の入力値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}}},"CollectorProductsOffers":{"type":"object","description":"SKU別価格、販売可否","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":{"type":"array","description":"追加属性情報","minItems":1,"items":{"type":"object","properties":{"@type":{"type":"string","description":"タイプ","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"追加属性識別値"},"value":{"description":"属性値"}}}}}},"CollectorProductsPriceSpecification":{"type":"object","description":"価格タイプ","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":{"type":"object","description":"商品画像情報","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":"属性値"}}}},"required":["contentUrl"]}}}}
```
## 商品修正
> 商品データ収集API - 修正
```json
{"openapi":"3.0.3","info":{"title":"商品データ収集API","version":"1.0.0"},"tags":[{"name":"商品データ収集API"}],"servers":[{"url":"https://api.gelatto.jp","description":"Production"}],"paths":{"/collector/products":{"put":{"summary":"商品修正","description":"商品データ収集API - 修正","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.0"]},"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":{"type":"array","description":"商品データ","minItems":1,"maxItems":1000,"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"},{"type":"string","description":"商品名"}]},"logo":{"type":"array","description":"ブランドロゴ画像URL","items":{"type":"string","description":"ブランドロゴ画像URL"}}}},"category":{"description":"商品カテゴリ情報","oneOf":[{"type":"array","description":"商品カテゴリ情報","items":{"$ref":"#/components/schemas/CollectorProductsCategory"}},{"$ref":"#/components/schemas/CollectorProductsCategory"}]},"positiveNotes":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsPositiveNote"}},{"$ref":"#/components/schemas/CollectorProductsPositiveNote"},{"type":"array","description":"商品の主な特徴および利点","items":{"type":"string"}},{"type":"string","description":"商品の主な特徴および利点"}]},"url":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsUrl"}},{"$ref":"#/components/schemas/CollectorProductsUrl"},{"type":"array","description":"商品詳細ページURL","items":{"type":"string"}},{"type":"string","description":"商品詳細ページURL"}]},"mobileUrl":{"oneOf":[{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsMobileUrl"}},{"$ref":"#/components/schemas/CollectorProductsMobileUrl"},{"type":"array","description":"モバイル商品詳細ページURL","items":{"type":"string"}},{"type":"string","description":"モバイル商品詳細ページURL"}]},"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"},{"type":"array","description":"商品素材情報","items":{"type":"string"}},{"type":"string","description":"商品素材情報"}]},"additionalProperty":{"type":"array","description":"追加属性情報","minItems":1,"items":{"type":"object","properties":{"@type":{"type":"string","description":"タイプ","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"追加属性識別値"},"value":{"description":"属性値"}}}},"offers":{"oneOf":[{"$ref":"#/components/schemas/CollectorProductsOffers"},{"type":"array","items":{"$ref":"#/components/schemas/CollectorProductsOffers"}}]}}}}}},"CollectorProductsLangName":{"type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"実際の入力値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}}},"CollectorProductsDescription":{"type":"object","description":"商品詳細説明情報","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":{"type":"array","description":"追加属性情報","minItems":1,"items":{"type":"object","properties":{"@type":{"type":"string","description":"タイプ","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"追加属性識別値"},"value":{"description":"属性値"}}}}}},"CollectorProductsDescriptionImage":{"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":{"type":"object","description":"ブランド名","properties":{"@value":{"type":"string","description":"実際の入力値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}},"required":["@value","@language"]},"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":{"type":"object","description":"商品の主な特徴および利点の要約","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"実際の入力値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}}},"CollectorProductsUrl":{"type":"object","description":"商品詳細ページURL","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"実際の入力値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}}},"CollectorProductsMobileUrl":{"type":"object","description":"モバイル商品詳細ページURL","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"実際の入力値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}}},"CollectorProductsMaterial":{"type":"object","description":"商品素材情報","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"実際の入力値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}}},"CollectorProductsOffers":{"type":"object","description":"SKU別価格、販売可否","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":{"type":"array","description":"追加属性情報","minItems":1,"items":{"type":"object","properties":{"@type":{"type":"string","description":"タイプ","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"追加属性識別値"},"value":{"description":"属性値"}}}}}},"CollectorProductsPriceSpecification":{"type":"object","description":"価格タイプ","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":{"type":"object","description":"商品画像情報","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":"属性値"}}}},"required":["contentUrl"]}}}}
```
## 商品削除
> 商品データ削除をリクエストします。
```json
{"openapi":"3.0.3","info":{"title":"商品データ収集API","version":"1.0.0"},"tags":[{"name":"商品データ収集API"}],"servers":[{"url":"https://api.gelatto.jp","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.0"]},"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}}}}}}
```