本頁面記載 Merchant API 的已知開發人員問題。
產品和商品目錄 insert 方法的總處理量問題
報告日期：2026 年 1 月 28 日 (世界標準時間) | 上次更新日期：2026 年 3 月 31 日 (世界標準時間)
我們收到回報，指出在將大量資料傳輸至 Merchant API 時，用戶端效能會出現輸送量問題。使用下列方法的用戶端程式庫時，可能會遇到這個問題：
accounts.productInputs.insertaccounts.products.localInventories.insertaccounts.products.regionalInventories.insert
我們已進行改良，提升多個後端系統的效能。 如果仍遇到這個問題，你可能需要設定頻道集區，盡量提高輸送量。這項功能會管理多個基礎連線，藉此略過單一 gRPC 通道的 100 個串流限制。詳情請參閱「重構程式碼以處理並行要求：使用管道集區提升輸送量」。
含有特殊字元的產品 ID
回報時間：2025 年 10 月 3 日 (世界標準時間) | 上次更新時間：2026 年 4 月 8 日 (世界標準時間)
如果 productId 或 offerId 不符合產品 ID 格式規範，使用者在管理產品時可能會遇到問題。這類產品 ID 可能包含特殊字元，最常見的是斜線 (/)、半形冒號 (:)、波浪號 (~) 和百分比符號 (%)。Merchant Center 等平台已允許產品 ID 包含部分特殊字元。
由於 Merchant API 會將產品 ID 直接併入網址的資源 name (例如 accounts/{account}/products/{productId})，這些字元可能會干擾標準網址的路由和剖析作業，導致在 GET、PATCH 或 DELETE 作業期間發生非預期的 404 Not Found 或 400 Bad Request 錯誤。
如要安全地與含有這些字元的產品互動，您必須編碼資源名稱的 productId 或 offerId 區段。編碼演算法為不含填補的 Base64URL 編碼。詳情請參閱 accounts.productInputs.name。
已解決：我們已推出解決方案，在 Merchant API 生態系統中統一行為。我們在 API 回應中新增了 base64_encoded_name 欄位，提供預先編碼的資源名稱，讓您直接將清單或取得呼叫的輸出內容做為後續更新的輸入內容，不必手動編碼。
資料來源建立後的延遲時間
回報時間：2024 年 4 月 10 日 (世界標準時間) | 上次更新時間：2024 年 5 月 12 日 (世界標準時間)
建立新 DataSource 後，如果嘗試立即插入產品、促銷活動或評論，可能會發生已知延遲。嘗試在資料來源建立後 5 分鐘內插入項目時，系統傳回 Data source not found 錯誤。
已解決：這個延遲問題已解決，現在可以更即時地與新建立的資料來源互動。
還有其他問題嗎？
如有其他問題，請前往「取得 Merchant API 相關協助」 和「提供意見回饋」 頁面。