舊截圖上傳程式仍可執行，但新 API 已把相關素材資源標記為棄用。 最快解法：新整合直接採用 App Asset Library；既有整合按素材類型遷移至資產與 placement 模型，並逐個 App 驗證上傳、擺放及排序，不要把棄用誤當成即時停服。Apple API 4.5.1 發布說明
適合自動上傳 App Store 截圖或預覽影片的獨立開發者：核對舊介面與新資源模型的對應關係。 維護多個 App 或自訂產品頁素材的小型團隊：規劃分批遷移與驗收。 負責應用程式內活動媒體自動化的開發者：確認舊活動素材資源的替代方向。
最後更新於 2026 年 10 月 15 日；日期及介面棄用狀態核對自 Apple API 4.5.1 發布說明、素材遷移指南及相關 API 參考資料。
先按遷移風險選擇處理方式
Apple 在 2026 年 10 月 6 日發布 App Store Connect API 4.5.1，將舊截圖集、截圖、預覽集、預覽及部分應用程式內活動素材資源標記為棄用，並指向 App Asset Library。日期與棄用狀態可在官方發布說明核對；棄用本身不表示舊介面已停止工作，也沒有因此得出未公布的停用期限。
遷移決策不應只看程式碼是否呼叫舊端點，還要看素材種類、近期發布安排，以及你是否需要修改既有自動化。可依以下條件分流：
- 若正在建立新整合，直接採用 App Asset Library；避免新程式碼再依賴已標記棄用的資源。
- 若既有流程會上傳、讀取或清理舊素材，安排分批遷移；先處理近期需要發布的 App，再逐類驗證，不必把棄用解讀成必須立即重傳全部素材。
- 若程式沒有碰到舊素材介面，暫時不必為了版本號改動無關流程；把 API 參考資料納入例行檢查即可。
- 若你無法確認目前使用哪些素材端點，先盤點呼叫與日誌，再決定遷移範圍；不要只替換上傳請求便宣告完成。
用資產與 placement 分離展示位置
舊 set-based 模型以展示位置為中心：建立素材集，再把截圖或預覽放進對應集合。App Asset Library 則把素材本體與展示位置拆開，先管理圖片或影片資產，再以 placement 表達素材要用在哪個頁面或展示情境。
| 核對面向 | 舊 set-based 模型 | App Asset Library 模型 | 遷移時要確認 |
|---|---|---|---|
| 素材本體 | 素材隸屬於特定素材集 | 圖片或影片以資產管理 | 本機素材檔與 API 資產 ID 是否可追蹤 |
| 展示位置 | 素材集通常承載位置語意 | 以 placement 關聯展示情境 | placement 是否指向正確頁面與本地化 |
| 素材重用 | 容易把素材與集合操作綁在一起 | 可評估同一資產關聯多個位置 | 每個關聯是否獲 API 接受並在頁面正確顯示 |
| 清理與排序 | 常沿用集合層級的操作假設 | 資產與 placement 的生命週期需分別核對 | 刪除順序、關聯清理及展示順序是否符合預期 |
以素材類型盤點介面覆蓋範圍
遷移前先列出自動化實際操作的素材，而不是只搜尋程式中的上傳函式。App Store 版本截圖與預覽、自訂產品頁素材、產品頁實驗素材，以及應用程式內活動素材，可能分布在不同工作流程；每一類都應檢查讀取、建立或上傳、修改、刪除和排序。
可建立一份內部對照清單，將每種舊資源記錄到新模型的 image、video 或 placement 操作。這是一個盤點框架，不代表所有舊資源都能用單一資產類型取代；具體對應須以 Apple 遷移文件及該素材類型的 API 參考資料為準。
常見遺漏不在「檔案能不能上傳」，而在上傳以外的狀態：
- 讀取端仍從舊素材集取資料，導致後續更新找不到新資產。
- 清理程式只刪除舊集合，沒有處理新資產與 placement 的關聯。
- 排序仍寫在舊資源上，實際展示順序卻由另一層關聯決定。
- 應用程式內活動素材仍沿用舊操作，卻沒有確認其替代資源及頁面狀態。
讓規格探索取代硬編碼
新流程不應把裝置展示類別、尺寸限制或 placement group 固定成永久常數。先從 API reference data 讀取目前可用的 placement 類型、群組與規格，再依回傳內容決定素材能否用於目標位置。這可避免 Apple 調整展示能力後，程式仍依賴過期的本地清單。
API 4.5.1 相關文件提供 IPHONE_DUO 展示類別；這應納入能力探索，而不是直接推論任何素材都可放入該類別。能否用於特定頁面，仍要以參考資料回傳內容及 API 處理結果為準。你可從素材狀態說明核對資產狀態，並參照上傳素材文件確認上傳流程的狀態邊界。
把上傳、關聯、排序及刪除一起遷移
一張圖片成功上傳，並不等於它已出現在產品頁。請把流程拆成可觀察的狀態：建立資產、等待處理、建立 placement、確認本地化與展示位置、驗證排序，最後再確認 App Store Connect 頁面選用的素材。每個階段保留資產 ID、placement ID、請求結果及錯誤訊息，才能在失敗時定位是哪一層未完成。
同一素材要供不同本地化頁面使用時，先確認資產是否符合各位置要求，再分別建立所需的關聯；不要把「可重用」理解成「任何語言頁都會自動沿用」。更新素材時，記錄舊資產與新資產的對照；刪除時先檢查 placement 是否仍引用該資產，再依 API 回應處理關聯及資產清理。沿用舊 set 的刪除假設，可能留下無用關聯，也可能因依賴尚未解除而失敗。
用可重現的驗收結果封閉遷移
挑選一個仍可編輯的素材場景，按以下順序走完端到端驗收：
- 記錄測試 App、素材類型、本地化及預定展示位置，避免把不同場景的結果混在一起。
- 建立圖片或影片資產，保存 API 回應與資產識別資料；不要只記錄檔案已送出。
- 查詢處理狀態，確認資產進入可供後續操作的狀態；若仍在處理或回報錯誤，不要繼續將它當成已完成素材。
- 建立 placement，核對 reference data 支援的展示類別、本地化及群組。
- 檢查排序與頁面選擇結果，並分別記錄 API 狀態和 App Store Connect 介面所見狀態。
- 測試更新與清理流程，確認移除或替換素材後，頁面沒有殘留錯誤關聯。
若你的素材生成、簽名或發布腳本需要持續在 macOS 執行，遠端 Mac 可提供一個常駐執行環境，但它不是呼叫 App Store Connect API 的必要條件。你可先查看 MACGPU 的遠端 Mac 方案，判斷是否需要把素材自動化與既有建置流程放在同一台 Mac；若只執行一般 API 請求，現有伺服器或 CI 環境可能已足夠。需要評估其他 Mac 使用方式時，也可參閱 MACGPU 服務資訊。
常見問題
App Asset Library 能否直接取代所有舊素材集？
不能只按名稱一對一替換。先按截圖、預覽、自訂產品頁、產品頁實驗或應用程式內活動盤點，再對照 Apple 遷移文件中的資產與 placement 概念。某個舊資源如何映射，應以該類素材的 API 參考資料為依據；不要假定所有素材都只需要建立一個 image 或 video。
同一張截圖如何對應不同本地化頁面？
先把圖片作為資產管理，再按目標頁面及本地化建立 placement 關聯。確認 reference data 回傳的可用位置與規格，並驗證 API 處理結果及頁面最後選用的素材。若頁面需要不同語言版本的圖片，應分別管理對應素材，而不是期待單一資產自動產生翻譯或替換畫面。
IPHONE_DUO 代表所有素材都能用於該位置嗎？
不是。IPHONE_DUO 是文件列出的展示類別，可作為能力探索時需要辨識的資訊；它本身不保證某張圖片符合該位置的格式或其他要求。讀取當前 API reference data，依回傳規格建立 placement，再用處理結果及頁面呈現完成驗收。
上傳成功後，還要檢查哪些狀態？
至少分開檢查資產處理狀態、placement 是否建立、展示順序及 App Store Connect 頁面是否選用該素材。需要送審的內容還要另外確認審核狀態。請保存 API 回應與頁面狀態，避免把檔案傳輸成功誤判為素材已上架或審核通過。
如果你目前仍依賴舊素材集，主要風險是新功能繼續綁定棄用模型、讀取與清理邏輯漏遷移，以及排序結果在頁面上無法確認；但這並不構成必須立即重傳全部素材的理由。先按素材類型遷移並完成端到端驗收，再判斷執行環境：若發布自動化需要持續使用 macOS、又不想為打包流程添置自有硬體，可評估租用 MACGPU 遠端 Mac；若工作只需呼叫 API，則沒有必要為此額外配置 Mac。