商品の画像を設定する
必要なスコープ: products:write。multipart/form-data の file 欄に画像を1枚送る。形式は中身で判定し、申告された Content-Type は見ない。既存の画像は差し替える(URL が変わる)。
/products/{product_id}/imageAuthorizationBearer トークン · header必須管理画面または CLI の cozeni login で発行したクリエイターAPIキー。購入者認証には使わない。
product_idstring必須multipart/form-datafileany必須JPEG・PNG・WebP、5MBまで。
公開商品情報。リンクは別APIで取得する。
idstring必須namestring必須price_jpyinteger必須currencystring必須jpyrecurring_intervalstring | null必須支払いタイプ。null(省略)は買い切り、month は月額、year は年額のサブスク。作成後は変えられない。
monthyearnulltrial_intervalstring | null必須無料トライアルの期間の単位。trial_interval_count と両方そろえる。null(両方)でトライアルなし。定期の商品だけ。
dayweekmonthyearnulltrial_interval_countinteger | null必須無料トライアルの期間の長さ。上限は単位ごと(day 730・week 104・month 24・year 2)。
access_urlstring | null必須access_typestring必須pagefeaturefilemetadataExternalFeatureFlagMetadata必須機能フラグの設定値。50件まで。キーは1〜40字の英数字・_・-(proto は不可)。値は文字列(1〜500字)・数値・真偽値。URLやAPIキーなどの秘匿情報は入れない。
descriptionstring | null必須imagesExternalProductImage[]必須プロパティを表示プロパティを非表示
ExternalProductImage の配列idstring必須urlstring<uri>必須content_typestring必須size_bytesinteger必須statusstring必須activearchivedcreated_atstring<date-time>必須updated_atstring<date-time>必須invalid_input。未知フィールド、無効なcursor・入力を含む。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須unauthorized。失効、期限切れ、環境違いを含む。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須insufficient_scope。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須product_not_found / checkout_link_not_found。他人の商品も404。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須idempotency_conflict / product_archived / checkout_link_disabled。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須image_too_large。5MB(5,242,880 バイト)を超える。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須unsupported_image_type。JPEG・PNG・WebP 以外(中身で判定する)。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須rate_limited。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須internal。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須unavailable。
errorobject必須プロパティを表示プロパティを非表示
codestring必須messagestring必須request_idstring必須