商品データ収集API

商品登録

post

商品データ収集API

Header parameters

Content-Typestring · enumRequired

コンテンツタイプ

Possible values:

Api-KeystringRequired

APIキー

Body

顧客企業の商品データ収集

@contextstring · enumOptional

スキーマ context

Possible values:

specversionstring · enumOptional

スペックバージョン

Possible values:

idstring · enumOptional

イベント固有識別子

Possible values:

typestring · enumOptional

商品収集タイプ

Possible values:

Responses

200

収集成功

No content

400

不正なリクエスト

503

サービス一時利用不可

post/collector/products

POST /collector/products HTTP/1.1
Host: api.gelatto.jp
Api-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 2731

{
  "@context": "https://schema.org",
  "specversion": "1.0",
  "id": "EVT-CREATE-PRODUCT",
  "type": "create_product",
  "agent": {
    "@type": "Organization",
    "name": "Sample Seller Inc."
  },
  "@graph": [
    {
      "@type": "Product",
      "sku": "SKU-0001",
      "name": {
        "@value": "プレミアムワイヤレスヘッドホン",
        "@language": "ja"
      },
      "description": {
        "@type": "TextObject",
        "text": "ノイズキャンセリング機能を搭載したプレミアムワイヤレスヘッドホンです。",
        "inLanguage": "ja",
        "additionalProperty": [
          {
            "@type": "PropertyValue",
            "propertyID": "sub_description",
            "value": [
              "プレミアムワイヤレスヘッドホン"
            ]
          }
        ]
      },
      "brand": {
        "@type": "Brand",
        "@id": "BRD-001",
        "name": [
          {
            "@value": "SoundMax",
            "@language": "en"
          }
        ],
        "logo": [
          "https://example.com/images/logo.png"
        ]
      },
      "category": [
        {
          "@type": "CategoryCode",
          "codeValue": "ELEC-HEADPHONE",
          "name": [
            {
              "@value": "ヘッドホン",
              "@language": "ja"
            }
          ],
          "position": 1
        }
      ],
      "color": "ブラック",
      "positiveNotes": [
        {
          "@value": "装着感が快適で音質に優れています",
          "@language": "ja"
        }
      ],
      "url": [
        {
          "@value": "https://example.com/products/sku-12345",
          "@language": "ja"
        }
      ],
      "itemCondition": "NewCondition",
      "hasAdultConsideration": "AlcoholConsideration",
      "countryOfOrigin": {
        "@type": "Country",
        "address": "JP"
      },
      "material": [
        {
          "@value": "プラスチック",
          "@language": "ja"
        },
        {
          "@value": "アルミニウム",
          "@language": "ja"
        }
      ],
      "offers": [
        {
          "@type": "Offer",
          "sku": "SKU-0001",
          "gtin": 881234567890,
          "mpn": "SMX-WH-900",
          "price": 29900,
          "priceCurrency": "JPY",
          "priceSpecification": {
            "@type": "UnitPriceSpecification",
            "priceType": "SalePrice",
            "price": 29900,
            "priceCurrency": "JPY",
            "unitCode": "C62"
          },
          "color": "ブラック",
          "size": "XL-1",
          "availability": "InStock",
          "availabilityStarts": "2026-01-01T00:00:00+09:00Z",
          "availabilityEnds": "2026-12-31T23:59:59+09:00Z",
          "inventoryLevel": {
            "@type": "QuantitativeValue",
            "value": 150
          },
          "shippingDetails": {
            "@type": "OfferShippingDetails",
            "weight": {
              "@type": "QuantitativeValue",
              "value": 0.85,
              "unitCode": "KGM"
            }
          },
          "image": [
            {
              "@type": "ImageObject",
              "representativeOfPage": false,
              "contentUrl": "https://example.com/images/sku-12345.jpg"
            }
          ]
        },
        {
          "@type": "Offer",
          "sku": "SKU-0001-BLK",
          "gtin": 881234567890,
          "mpn": "SMX-WH-900",
          "price": 29900,
          "priceCurrency": "JPY",
          "priceSpecification": {
            "@type": "UnitPriceSpecification",
            "priceType": "SalePrice",
            "price": 29900,
            "priceCurrency": "JPY",
            "unitCode": "C62"
          },
          "color": "ブラック",
          "size": "XL-1",
          "availability": "InStock",
          "availabilityStarts": "2026-01-01T00:00:00+09:00Z",
          "availabilityEnds": "2026-12-31T23:59:59+09:00Z",
          "inventoryLevel": {
            "@type": "QuantitativeValue",
            "value": 150
          },
          "shippingDetails": {
            "@type": "OfferShippingDetails",
            "weight": {
              "@type": "QuantitativeValue",
              "value": 0.85,
              "unitCode": "KGM"
            }
          },
          "image": [
            {
              "@type": "ImageObject",
              "representativeOfPage": false,
              "contentUrl": "https://example.com/images/sku-12345.jpg"
            }
          ]
        }
      ]
    }
  ]
}

No content

商品修正

put

商品データ収集API - 修正

Header parameters

Content-Typestring · enumRequired

コンテンツタイプ

Possible values:

Api-KeystringRequired

APIキー

Body

顧客企業の商品データ収集

@contextstring · enumOptional

スキーマ context

Possible values:

specversionstring · enumOptional

スペックバージョン

Possible values:

idstring · enumOptional

イベント固有識別子

Possible values:

typestring · enumOptional

商品収集タイプ

Possible values:

Responses

200

収集成功

No content

400

不正なリクエスト

503

サービス一時利用不可

put/collector/products

PUT /collector/products HTTP/1.1
Host: api.gelatto.jp
Api-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 2568

{
  "@context": "https://schema.org",
  "specversion": "1.0",
  "id": "EVT-CREATE-PRODUCT",
  "type": "create_product",
  "agent": {
    "@type": "Organization",
    "name": "Sample Seller Inc."
  },
  "@graph": [
    {
      "@type": "Product",
      "sku": "SKU-12345",
      "name": {
        "@value": "プレミアムワイヤレスヘッドホン",
        "@language": "ja"
      },
      "description": {
        "@type": "TextObject",
        "text": "ノイズキャンセリング機能を搭載したプレミアムワイヤレスヘッドホンです。",
        "inLanguage": "ja"
      },
      "brand": {
        "@type": "Brand",
        "@id": "brand-001",
        "name": [
          {
            "@value": "SoundMax",
            "@language": "en"
          }
        ],
        "logo": [
          "https://example.com/images/logo.png"
        ]
      },
      "category": [
        {
          "@type": "CategoryCode",
          "codeValue": "ELEC-HEADPHONE",
          "name": [
            {
              "@value": "ヘッドホン",
              "@language": "ja"
            }
          ],
          "position": 1
        }
      ],
      "color": "ブラック",
      "positiveNotes": [
        {
          "@value": "装着感が快適で音質に優れています",
          "@language": "ja"
        }
      ],
      "url": [
        {
          "@value": "https://example.com/products/sku-12345",
          "@language": "ja"
        }
      ],
      "itemCondition": "NewCondition",
      "hasAdultConsideration": "AlcoholConsideration",
      "countryOfOrigin": {
        "@type": "Country",
        "address": "JP"
      },
      "material": [
        {
          "@value": "プラスチック、アルミニウム",
          "@language": "ja"
        }
      ],
      "offers": [
        {
          "@type": "Offer",
          "sku": "SKU-12345",
          "gtin": 881234567890,
          "mpn": "SMX-WH-900",
          "price": 29900,
          "priceCurrency": "JPY",
          "priceSpecification": {
            "@type": "UnitPriceSpecification",
            "priceType": "SalePrice",
            "price": 29900,
            "priceCurrency": "JPY",
            "unitCode": "C62"
          },
          "color": "ブラック",
          "size": "XL-1",
          "availability": "InStock",
          "availabilityStarts": "2026-01-01T00:00:00+09:00Z",
          "availabilityEnds": "2026-12-31T23:59:59+09:00Z",
          "inventoryLevel": {
            "@type": "QuantitativeValue",
            "value": 150
          },
          "shippingDetails": {
            "@type": "OfferShippingDetails",
            "weight": {
              "@type": "QuantitativeValue",
              "value": 0.85,
              "unitCode": "KGM"
            }
          },
          "image": [
            {
              "@type": "ImageObject",
              "representativeOfPage": false,
              "contentUrl": "https://example.com/images/sku-12345.jpg"
            }
          ]
        },
        {
          "@type": "Offer",
          "sku": "SKU-12345-1",
          "gtin": 881234567890,
          "mpn": "SMX-WH-900",
          "price": 29900,
          "priceCurrency": "JPY",
          "priceSpecification": {
            "@type": "UnitPriceSpecification",
            "priceType": "SalePrice",
            "price": 29900,
            "priceCurrency": "JPY",
            "unitCode": "C62"
          },
          "color": "ブラック",
          "size": "XL-1",
          "availability": "InStock",
          "availabilityStarts": "2026-01-01T00:00:00+09:00Z",
          "availabilityEnds": "2026-12-31T23:59:59+09:00Z",
          "inventoryLevel": {
            "@type": "QuantitativeValue",
            "value": 150
          },
          "shippingDetails": {
            "@type": "OfferShippingDetails",
            "weight": {
              "@type": "QuantitativeValue",
              "value": 0.85,
              "unitCode": "KGM"
            }
          },
          "image": [
            {
              "@type": "ImageObject",
              "representativeOfPage": false,
              "contentUrl": "https://example.com/images/sku-12345.jpg"
            }
          ]
        }
      ]
    }
  ]
}

No content

商品削除

put

商品データ削除をリクエストします。

Header parameters

Content-Typestring · enumRequired

コンテンツタイプ

Possible values:

Api-KeystringRequired

APIキー

Body

顧客企業の商品データ削除リクエスト収集

@contextstring · enumOptional

スキーマ context

Possible values:

specversionstring · enumOptional

スペックバージョン

Possible values:

idstring · enumOptional

イベント固有識別子

Possible values:

typestring · enumOptional

商品収集タイプ

Possible values:

Responses

200

収集成功

No content

400

不正なリクエスト

503

サービス一時利用不可

put/collector/products-delete

PUT /collector/products-delete HTTP/1.1
Host: api.gelatto.jp
Api-Key: text
Content-Type: application/json
Accept: */*
Content-Length: 213

{
  "@context": "https://schema.org",
  "specversion": "1.0",
  "id": "EVT-DELETE-PRODUCT",
  "type": "delete_product",
  "agent": {
    "@type": "Organization",
    "name": "Sample Seller Inc."
  },
  "@graph": [
    {
      "@type": "Product",
      "sku": "SKU-12345"
    }
  ]
}

No content