產品

在選定上下文中讀取、建立、更新和刪除目錄產品。

操作

取得清單 — 產品讀取「產品」的資料。結果取決於此操作的參數。 GET 取得 — 產品查看產品清單和產品詳細資訊。 GET 建立 — 產品將新產品新增至目錄。 POST 更新 — 產品更改現有產品、價格和出版資料。 PATCH 刪除 — 產品從管理面板、商店和搜尋中移除商品，同時保留歷史交易資料。 DELETE 產品 · 新增檔案 · upload_id建立 upload_id 後，以 multipart/form-data 上傳檔案，再關聯至商品。下載需要 Bearer 權杖及 category 對應權限；回應直接包含檔案位元組，不使用公開網址或密碼。共用銷售檔案的明確存取規則。 new_purchases / recent_and_new / selected / all_purchasers. POST 產品 · 狀態 · upload_id建立 upload_id 後，以 multipart/form-data 上傳檔案，再關聯至商品。下載需要 Bearer 權杖及 category 對應權限；回應直接包含檔案位元組，不使用公開網址或密碼。共用銷售檔案的明確存取規則。 new_purchases / recent_and_new / selected / all_purchasers. GET 產品 · 新增檔案 · multipart建立 upload_id 後，以 multipart/form-data 上傳檔案，再關聯至商品。下載需要 Bearer 權杖及 category 對應權限；回應直接包含檔案位元組，不使用公開網址或密碼。共用銷售檔案的明確存取規則。 new_purchases / recent_and_new / selected / all_purchasers. PUT 產品 · 商品檔案建立 upload_id 後，以 multipart/form-data 上傳檔案，再關聯至商品。下載需要 Bearer 權杖及 category 對應權限；回應直接包含檔案位元組，不使用公開網址或密碼。共用銷售檔案的明確存取規則。 new_purchases / recent_and_new / selected / all_purchasers. GET 產品 · 新增檔案 · product_id建立 upload_id 後，以 multipart/form-data 上傳檔案，再關聯至商品。下載需要 Bearer 權杖及 category 對應權限；回應直接包含檔案位元組，不使用公開網址或密碼。共用銷售檔案的明確存取規則。 new_purchases / recent_and_new / selected / all_purchasers. POST 產品 · 下載 · 檔案建立 upload_id 後，以 multipart/form-data 上傳檔案，再關聯至商品。下載需要 Bearer 權杖及 category 對應權限；回應直接包含檔案位元組，不使用公開網址或密碼。共用銷售檔案的明確存取規則。 new_purchases / recent_and_new / selected / all_purchasers. GET 產品 · 請求標頭與回應標頭建立 upload_id 後，以 multipart/form-data 上傳檔案，再關聯至商品。下載需要 Bearer 權杖及 category 對應權限；回應直接包含檔案位元組，不使用公開網址或密碼。共用銷售檔案的明確存取規則。 new_purchases / recent_and_new / selected / all_purchasers. HEAD 產品 · 新增檔案 · 版本建立 upload_id 後，以 multipart/form-data 上傳檔案，再關聯至商品。下載需要 Bearer 權杖及 category 對應權限；回應直接包含檔案位元組，不使用公開網址或密碼。共用銷售檔案的明確存取規則。 new_purchases / recent_and_new / selected / all_purchasers. POST 產品 · 移除 · 檔案建立 upload_id 後，以 multipart/form-data 上傳檔案，再關聯至商品。下載需要 Bearer 權杖及 category 對應權限；回應直接包含檔案位元組，不使用公開網址或密碼。共用銷售檔案的明確存取規則。 new_purchases / recent_and_new / selected / all_purchasers. DELETE 產品 · 數位版本建立 upload_id 後，以 multipart/form-data 上傳檔案，再關聯至商品。下載需要 Bearer 權杖及 category 對應權限；回應直接包含檔案位元組，不使用公開網址或密碼。共用銷售檔案的明確存取規則。 new_purchases / recent_and_new / selected / all_purchasers. GET 產品 · 新增檔案 · 草稿此操作已停用，回傳409且不會修改資料。請透過接收對象選擇，為每個數位檔案個別設定存取權限。 POST 產品 · 請求 · 草稿此操作已停用，回傳409且不會修改資料。請透過接收對象選擇，為每個數位檔案個別設定存取權限。 PATCH 產品 · 移除 · 草稿此操作已停用，回傳409且不會修改資料。請透過接收對象選擇，為每個數位檔案個別設定存取權限。 DELETE 產品 · 發佈版本此操作已停用，回傳409且不會修改資料。請透過接收對象選擇，為每個數位檔案個別設定存取權限。 POST 產品 · 撤回銷售此操作已停用，回傳409且不會修改資料。請透過接收對象選擇，為每個數位檔案個別設定存取權限。 POST 產品 · 購買後對未來檔案的存取權限此操作已停用，回傳409且不會修改資料。請透過接收對象選擇，為每個數位檔案個別設定存取權限。 PATCH 讀取檔案接收對象讀取存取規則與商品版本。首次發佈時間保持不變。 GET 選擇檔案接收對象選擇符合資格的購買。所選訂單必須包含已付款且未退款的此商品。 PATCH

工作原理

整合可以讀取所有未刪除的產品，包括草稿，但不包括被方案限制阻止的產品。被阻止的產品不出現在清單中；直接存取回傳 entitlements.resource_blocked。因此，產品在 API 中的可見性不同於店面發佈狀態。

使用品牌、分類、屬性和媒體的現有識別碼。價格包含明確的幣種、價格表、稅務模式和並行控制版本。產品定價與變體定價相互獨立；請使用支援的價格結構及精確的十進位字串。

商品檔案

建立 upload_id 後，以 multipart/form-data 上傳檔案，再關聯至商品。下載需要 Bearer 權杖及 category 對應權限；回應直接包含檔案位元組，不使用公開網址或密碼。共用銷售檔案的明確存取規則。 new_purchases / recent_and_new / selected / all_purchasers.

請選擇有效的 PDF、ZIP、EPUB、MP3 或 MP4, WebP, PNG, JPG, SVG, AVIF 檔案。每個檔案最大 250 MiB. 每件商品最多可有 20 個有效檔案。