已知問題

本頁面說明開發人員對 Merchant API 的已知疑慮。

UnauthenticatedException 個隨機錯誤

回報時間：2026 年 3 月 30 日 (世界標準時間)

多位顧客在上傳產品和存取其他 Merchant Center API 時，會間歇性發生UnauthenticatedException 錯誤。 即使重試，錯誤仍會隨機發生，且會影響初始呼叫和後續嘗試。部分連線在短時間內失敗，其他連線則成功。

目前沒有解決方法或建議。

產品和目錄方法的回應時間變長、DEADLINE_EXCEEDED 和 INTERNAL_ERROR 訊息

回報時間：2026 年 3 月 18 日 (世界標準時間) | 解決時間：2026 年 3 月 31 日 (世界標準時間)

部分使用者在使用 productInputs 和 regionalInventories 方法時，會持續發生延遲問題，並收到頻繁的 DEADLINE_EXCEEDED 或 INTERNAL_ERROR 訊息。主要原因是後端層級事件影響處理效率。

解決方式：這起事件已於 2026 年 3 月 31 日完全解決。緩解問題後，錯誤率已大幅降低。如果延遲時間仍過長，建議您確認用戶端逾時設定，並縮減要求批次大小。

產品和商品目錄 insert 方法的輸送量問題

回報時間：2026 年 1 月 28 日 (世界標準時間) | 上次更新時間：2026 年 3 月 31 日 (世界標準時間)

我們收到回報，指出向 Merchant API 傳輸大量資料時，用戶端效能會出現輸送量問題。使用下列方法的用戶端程式庫時，可能會遇到這個問題：

我們改善了多個後端系統，提升效能。 如果仍遇到這個問題，你可能需要設定通道集區，盡量提高輸送量。這項功能會管理多個基礎連線，藉此略過單一 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 相關協助」 和「提供意見回饋」 頁面。