> 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/wisshurisuto-wishlist.md).

# ウィッシュリスト (Wishlist)

ウィッシュリスト関連のユーザー行動収集API

## ウィッシュリスト追加

> ウィッシュリスト追加収集API

```json
{"openapi":"3.1.0","info":{"title":"Gelatto イベント収集API（基本）","version":"1.0.0"},"tags":[{"name":"ウィッシュリスト (Wishlist)","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":{"ActionsWishlistAddEvent":{"title":"ウィッシュリスト追加","description":"ユーザーが商品をウィッシュリストに追加する行動を収集します","type":"object","required":["time","source","data"],"properties":{"specversion":{"type":"string","description":"仕様バージョン","enum":["1.0.0"]},"id":{"type":"string","description":"イベントの一意識別子","enum":["EVT-ADD-TO-WISHLIST"]},"type":{"type":"string","description":"イベントタイプ","enum":["add_to_wishlist"]},"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/wishlist_add.json"]},"data":{"type":"object","description":"イベントデータオブジェクト","required":["agent","object"],"properties":{"@context":{"type":"string","description":"スキーマコンテキスト","enum":["https://schema.org/"]},"@type":{"type":"string","description":"アクションタイプ","enum":["AddAction"]},"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/ActionsWishlistAddOrderItem"},{"type":"array","items":{"$ref":"#/components/schemas/ActionsWishlistAddOrderItem"}}]},"target":{"type":"object","description":"エンドポイント情報","required":["urlTemplate"],"properties":{"@type":{"type":"string","enum":["EntryPoint"]},"urlTemplate":{"type":"string","description":"URL"}}}}}}},"ActionsWishlistAddOrderItem":{"description":"購入情報","type":"object","required":["orderedItem"],"properties":{"@type":{"type":"string","enum":["OrderItem"]},"orderedItem":{"$ref":"#/components/schemas/ActionsWishlistAddProduct"}}},"ActionsWishlistAddProduct":{"description":"商品オブジェクト","type":"object","required":["sku","name"],"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"]}}}}]},"offers":{"$ref":"#/components/schemas/ActionsWishlistAddOffer"}}},"ActionsWishlistAddOffer":{"description":"数量/価格オブジェクト","type":"object","required":["price","priceCurrency"],"properties":{"@type":{"type":"string","enum":["Offer"]},"price":{"type":"number","description":"販売価格"},"priceCurrency":{"type":"string","description":"ISO 4217 通貨コード（例：KRW、USD、JPY）"}}}}},"paths":{"/actions/wishlist/add":{"post":{"summary":"ウィッシュリスト追加","description":"ウィッシュリスト追加収集API","operationId":"collectWishlistAdd","tags":["ウィッシュリスト (Wishlist)"],"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/ActionsWishlistAddEvent"}}}},"responses":{"200":{"description":"収集成功"},"400":{"description":"不正なリクエスト"},"503":{"description":"一時的にサービスを利用できません"}}}}}}
```

## ウィッシュリスト削除

> ウィッシュリスト削除収集API

```json
{"openapi":"3.1.0","info":{"title":"Gelatto イベント収集API（基本）","version":"1.0.0"},"tags":[{"name":"ウィッシュリスト (Wishlist)","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":{"ActionsWishlistRemoveEvent":{"title":"ウィッシュリスト削除","description":"ユーザーが商品をウィッシュリストから削除する行動を収集します","type":"object","required":["time","source","data"],"properties":{"specversion":{"type":"string","description":"仕様バージョン","enum":["1.0.0"]},"id":{"type":"string","description":"イベントの一意識別子","enum":["EVT-REMOVE-FROM-WISHLIST"]},"type":{"type":"string","description":"イベントタイプ","enum":["remove_from_wishlist"]},"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/wishlist_remove.json"]},"data":{"type":"object","description":"イベントデータオブジェクト","required":["agent","object"],"properties":{"@context":{"type":"string","description":"スキーマコンテキスト","enum":["https://schema.org/"]},"@type":{"type":"string","description":"アクションタイプ","enum":["DeleteAction"]},"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/ActionsWishlistRemoveOrderItem"},{"type":"array","items":{"$ref":"#/components/schemas/ActionsWishlistRemoveOrderItem"}}]},"target":{"type":"object","description":"エンドポイント情報","required":["urlTemplate"],"properties":{"@type":{"type":"string","enum":["EntryPoint"]},"urlTemplate":{"type":"string","description":"URL"}}}}}}},"ActionsWishlistRemoveOrderItem":{"description":"購入情報","type":"object","required":["orderedItem"],"properties":{"@type":{"type":"string","enum":["OrderItem"]},"orderedItem":{"$ref":"#/components/schemas/ActionsWishlistRemoveProduct"}}},"ActionsWishlistRemoveProduct":{"description":"商品オブジェクト","type":"object","required":["sku","name"],"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"]}}}}]},"offers":{"$ref":"#/components/schemas/ActionsWishlistRemoveOffer"}}},"ActionsWishlistRemoveOffer":{"description":"数量/価格オブジェクト","type":"object","required":["price","priceCurrency"],"properties":{"@type":{"type":"string","enum":["Offer"]},"price":{"type":"number","description":"販売価格"},"priceCurrency":{"type":"string","description":"ISO 4217 通貨コード（例：KRW、USD、JPY）"}}}}},"paths":{"/actions/wishlist/remove":{"post":{"summary":"ウィッシュリスト削除","description":"ウィッシュリスト削除収集API","operationId":"collectWishlistRemove","tags":["ウィッシュリスト (Wishlist)"],"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/ActionsWishlistRemoveEvent"}}}},"responses":{"200":{"description":"収集成功"},"400":{"description":"不正なリクエスト"},"503":{"description":"一時的にサービスを利用できません"}}}}}}
```