> 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/action-data/api-references/shang-pin-product.md).

# 商品 (Product)

商品関連のユーザー行動収集API

## 商品クリック

> 商品クリック収集API

```json
{"openapi":"3.1.0","info":{"title":"Gelatto イベント収集API（基本）","version":"1.0.0"},"tags":[{"name":"商品 (Product)","description":"商品関連のユーザー行動収集API"}],"servers":[{"url":"https://api.gelatto.ai","description":"Production"},{"url":"https://api-dev.gelatto.ai","description":"Development"},{"url":"http://localhost","description":"Local Development (ポート80)"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Api-Key","description":"APIキー"}},"schemas":{"ActionsClickProductEvent":{"title":"商品クリック","description":"ユーザーが商品をクリックする行動を収集します","type":"object","required":["time","source","data"],"properties":{"specversion":{"type":"string","description":"仕様バージョン","enum":["1.0.0"]},"id":{"type":"string","description":"イベントの一意識別子","enum":["EVT-CLICK-PRODUCT"]},"type":{"type":"string","description":"イベントタイプ","enum":["click_product"]},"time":{"type":"string","description":"ISO 8601 UTC イベント作成時刻","format":"date-time"},"source":{"type":"string","description":"イベント発生元"},"datacontenttype":{"type":"string","description":"データコンテンツタイプ","enum":["application/ld+json"]},"dataschema":{"type":"string","description":"データスキーマパス","enum":["https://api.gelatto.ai/schema/actions/click_product.json"]},"data":{"type":"object","description":"イベントデータオブジェクト","required":["agent","object"],"properties":{"@context":{"type":"string","description":"スキーマコンテキスト","enum":["https://schema.org/"]},"@type":{"type":"string","description":"アクションタイプ","enum":["ChooseAction"]},"agent":{"type":"object","description":"実行者（Person）","required":["identifier"],"properties":{"@type":{"type":"string","enum":["Person"]},"identifier":{"items":{"type":"object","required":["propertyID","value"],"properties":{"@type":{"type":"string","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"プロパティID"},"value":{"type":"string","description":"値"}}},"type":"array","description":"実行者識別子リスト（userId、memberId、cookieIdは必須で追加する必要があります。属性の追加が必要な場合は協議）"},"gender":{"type":"string","enum":["Female","Male","https://schema.org/Female","https://schema.org/Male"]},"additionalProperty":{"items":{"type":"object","required":["propertyID","value"],"properties":{"@type":{"type":"string","enum":["PropertyValue"]},"propertyID":{"type":"string","description":"プロパティID"},"value":{"oneOf":[{"type":"string"},{"type":"number"}],"description":"値"}}},"type":"array","description":"追加属性"}}},"object":{"oneOf":[{"$ref":"#/components/schemas/ActionsClickProductItemList"},{"type":"array","items":{"$ref":"#/components/schemas/ActionsClickProductItemList"}}]},"target":{"type":"object","description":"エンドポイント情報","required":["urlTemplate"],"properties":{"@type":{"type":"string","enum":["EntryPoint"]},"urlTemplate":{"type":"string","description":"URL"}}}}}}},"ActionsClickProductItemList":{"description":"商品リストオブジェクト","type":"object","required":["itemListElement"],"properties":{"@type":{"type":"string","enum":["ItemList"]},"itemListElement":{"$ref":"#/components/schemas/ActionsClickProductListItem"}}},"ActionsClickProductListItem":{"description":"商品リスト項目","type":"object","required":["position","item"],"properties":{"@type":{"type":"string","enum":["ListItem"]},"item":{"$ref":"#/components/schemas/ActionsClickProductProduct"},"position":{"type":"number","description":"リスト内の表示順"}}},"ActionsClickProductProduct":{"description":"商品オブジェクト","type":"object","required":["sku"],"properties":{"@type":{"type":"string","enum":["Product"]},"sku":{"type":"string","description":"商品一意識別子、商品コード（SKU）"},"name":{"description":"商品名","oneOf":[{"description":"単純文字列","type":"string"},{"description":"多言語オブジェクト","type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"商品名の値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}}},{"description":"多言語配列","type":"array","items":{"type":"object","required":["@value","@language"],"properties":{"@value":{"type":"string","description":"商品名の値"},"@language":{"type":"string","description":"ISO 639-1 言語コード","enum":["ko","en","ja"]}}}}]}}}}},"paths":{"/actions/click/product":{"post":{"summary":"商品クリック","description":"商品クリック収集API","operationId":"collectClickProduct","tags":["商品 (Product)"],"parameters":[{"name":"Content-Type","in":"header","required":true,"schema":{"type":"string","enum":["application/json"]},"description":"コンテンツタイプ"},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"},"description":"べき等性キー - クライアントが呼び出し時に渡す必要があります（UUID）"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionsClickProductEvent"}}}},"responses":{"200":{"description":"収集成功"},"400":{"description":"不正なリクエスト"},"503":{"description":"一時的にサービスを利用できません"}}}}}}
```