常見錯誤

以下是最常見的錯誤：

以下列出依字母順序排列的錯誤清單。

auth/account_access_denied

User cannot access account <account_number>
摘要已發出要求，指定已驗證使用者無法存取的帳戶。
常見原因目標商家 ID 發生錯誤，或是忘記在 Merchant Center 中註冊使用者。
建議的處理提示請前往 Merchant Center (「設定」>「使用者」) 檢查您是否指定正確的帳戶，或將自己註冊為帳戶使用者。
預防秘訣不限
User is not an administrator of account <account_number>
摘要已發出修改要求，要求已驗證的使用者不具管理員權限。
常見原因不限
建議的處理提示設定已驗證使用者的管理員權限。
預防秘訣不限

衝突

[productId] Product ID <product id> is already modified by another entry in the same request for merchant <merchant> and store code <store code>
摘要嘗試同時嘗試多項衝突的作業。
常見原因單一批次要求包含同一產品的多項衝突作業，或是同一產品的多項衝突作業同時提交至 Content API。
建議的處理提示查看預防提示。
預防秘訣將特定產品的所有變更以批次要求的方式，加入單一作業。請盡量避免對同一個商家和商店代碼同時發出多次對 Content API 的呼叫，或是確保這些呼叫未包含重疊的產品。

internalError

Internal error
摘要Google 後端發生問題。
常見原因不限
建議的處理提示重試要求。 如果問題持續發生，請與我們聯絡。
預防秘訣不限

無效

Invalid channel: '<channel>'
摘要產品 ID 中包含的頻道無效。例如：not_a_channel:en:US:sku123。
常見原因不限
建議的處理提示不限
預防秘訣請確認產品 ID 的格式為 channel:languageCode:countryCode:offerId，例如 online:en:US:sku123。詳情請參閱 Products.insert 的參考說明文件。
[countrycode] Invalid country code: '<country_code>'
摘要產品 ID 中包含的國家/地區代碼無效。例如：online:en:not_a_country_code:sku123。
常見原因不限
建議的處理提示不限
預防秘訣請確認產品 ID 的格式為 channel:languageCode:countryCode:offerId，且國家/地區代碼是有效的 ISO 3166 國家/地區代碼。
[item id] Invalid item id: '<id>'
摘要項目 ID 無效，例如sku123，而非 online:en:US:sku123。
常見原因在 GET 或 DELETE 要求中指定優惠 ID，而不是產品 ID。
建議的處理提示不限
預防秘訣確認產品 ID 的格式為 channel:languageCode:countryCode:offerId。
[name] The term '<term>' is not allowed
摘要名稱包含禁止使用的字詞。
常見原因不限
建議的處理提示請使用系統允許的名稱。詳情請參閱動態饋給規格說明中心文章。
預防秘訣不限
[price.currency] Please use a currency that is supported in the target country
摘要指定的貨幣不適用於指定國家/地區。
常見原因不限
建議的處理提示確認貨幣和國家/地區正確無誤。詳情請參閱「動態饋給規格」說明中心文章的「price」一節。
預防秘訣不限
[storeCode] storeCode must be 'online'
摘要嘗試透過商品目錄動態饋給更新線上產品的價格和供應情形，但指定了網址中的特殊值 online 以外的商店 ID。
常見原因不限
建議的處理提示將要求網址中的商店 ID 變更為 online。
預防秘訣請務必在所有商品目錄查詢中，為線上產品指定 online，並為店面產品指定商店 ID。
[<attribute>]
摘要方括號中指定的項目無效。
常見原因不限
建議的處理提示為問題項目修正規格，詳情請參閱「動態饋給規格」說明中心文章。
預防秘訣不限

notFound

Item not found
摘要您嘗試取得、更新或刪除的項目不存在。
常見原因嘗試刪除不存在的產品，或是未在刪除網址中指定正確的產品 ID。
建議的處理提示使用 Products.list 取得產品清單，並只嘗試取得、更新或刪除其中的項目。請務必以 channel:languageCode:countryCode:offerId 的格式指定產品 ID，例如：online:ru:RU:277104-ekb，而不是優惠 ID，如下所示：277104-ekb。
預防秘訣不限

not_inserted

The item could not be inserted.
摘要由於其他錯誤，因此無法插入產品，因為這會覆寫現有的商品。
常見原因不限
建議的處理提示請先查看相同呼叫的其他錯誤並解決相關問題，然後再嘗試重新插入新的產品資訊。
預防秘訣不限

配額

too_many_items: Merchant quota exceeded
摘要上傳至 Google 購物的商品過多。
常見原因驗證失敗的產品如果未取代現有的有效產品，我們仍可能會插入產品。建議您為 Productstatuses.list 使用 includeInvalidInsertedItems 標記，確保帳戶中沒有過多的無效產品。
建議的處理提示

請檢查並移除上述數量的無效產品。此外，請在上傳產品時指定 到期日。到期日一到，系統就會自動刪除產品。請注意，產品插入或更新後的 30 天是預設值 (預設期限上限)。

注意事項：多重客戶帳戶的項目配額是根據所有子帳戶中的產品總數檢查。如果子帳戶發生這個錯誤，請確認子帳戶和 MCA 都有足夠的產品配額。

如果您已嘗試這些解決方案，但 Merchant Center 帳戶中新產品的空間仍不足，您可以 要求在帳戶中提交更多商品。

預防秘訣請參閱建議的處理提示。
too_many_subaccounts: Maximum number of subaccounts reached
摘要您的多重客戶帳戶允許的子帳戶數量已達上限。
常見原因不限
建議的處理提示

刪除過時的子帳戶。

只要您的帳戶有效，即可 要求在 MCA 中建立其他子帳戶。

預防秘訣不限
request_rate_too_high: Request rate too high. Please reduce your throughput
摘要要求傳送速度過快，請降低要求頻率。
常見原因請參閱發布限制中列出的每分鐘配額。如果超過這些門檻，就會收到這個錯誤。有時流量突然暴增而會造成這種情形，或是您的伺服器擴充至大量執行緒。
建議的處理提示請減少每分鐘傳送的要求總數。
預防秘訣收到這個錯誤時，請使用程式輔助輪詢策略，將要求比率降至適合的永續等級。
daily_limit_exceeded: merchant quota exceeded
摘要您針對特定服務方法提出的每日要求數量超過系統允許的上限。
常見原因請參閱已發布限制中列出的每日配額。如果超過這些門檻，就會收到這個錯誤。
建議的處理提示

在可能的情況下，將多項變更合併為單一要求，減少每天傳送的要求總數。建議在適當時間範圍內批次對產品進行批次變更，以免產品因故多次迅速變更。如果項目更新能以微資料的形式表示在網站上，請考慮使用這個方法來限制對 Products 或 Inventory 服務的呼叫次數。

如果仍須每天增加特定方法的呼叫次數，請與我們聯絡並提供 Merchant Center ID，以及這些方法每日需要的呼叫次數和原因，我們會協助您提高配額。

預防秘訣請參閱建議的處理提示。
too_many_failed_auths: Too many failed authentications.
摘要您目前無法存取帳戶的批次要求，
常見原因針對已刪除的子帳戶或尚未建立新建立的子帳戶，分批發出要求。
建議的處理提示請避免發出會影響這類子帳戶的呼叫。
預防秘訣請參閱建議的處理提示。
request_too_large
摘要每項批次要求傳送的 entries 數量過多，或超過 custombatch 的要求大小上限。
常見原因每個 custombatch 要求最多可包含 10,000 個 entries，壓縮後的傳輸大小上限為 32 MB。
建議的處理提示請將該批次分割為低於限制的多個批次，然後再試一次。
預防秘訣建議每個批次最多只能傳送 1,000 個項目。

必填

[price.value] Required parameter: price.value
摘要指定了未輸入值的價格。例如：{ "currency": "USD" }，而非 { "value": 123, "currency": "USD" }。
常見原因不限
建議的處理提示請確定 price 的參數格式正確無誤。舉例來說，price 有兩個必要欄位：value 和 currency。
預防秘訣不限
[product] INSERT request must specify product
摘要已向 API 提交自訂批次要求，其中包含含有 "method": "insert" 的項目，但沒有產品。
常見原因忘記將方法變更為 get 或 delete。
建議的處理提示透過 product 欄位指定要插入的產品。
預防秘訣請確保使用 insert 方法的批次項目指定產品，而使用方法 get 或 delete 方法的批次項目會指定產品 ID。
[productId] DELETE request must specify productId
摘要已向 API 提交自訂批次要求，其中包含項目為 "method": "delete" 但缺少產品 ID 的項目。
常見原因忘記將方法變更為 insert。
建議的處理提示透過 productID 欄位指定要刪除的產品。
預防秘訣請確保使用 insert 方法的批次項目指定產品，而使用方法 get 或 delete 方法的批次項目會指定產品 ID。

userRateLimitExceeded

User Rate Limit Exceeded
摘要要求傳送速度過快，請降低要求頻率。
常見原因請參閱發布限制中列出的 HTTP 要求限制。如果超過這些門檻，就會收到這個錯誤。有時會造成流量突然增加，或是您的伺服器擴充至大量執行緒。
建議的處理提示請減少每分鐘傳送的要求總數。將對同一項服務發出的多個方法呼叫批次處理至單一 custombatch 要求，可減少執行的 HTTP 要求數量。
預防秘訣收到這個錯誤時，請採用批次處理和程式輔助輪詢策略，將要求比率降至適合的永續等級。

validation

[adwords_redirect]
摘要提交的產品，但「adwords_redirect」欄位不是有效的網址。
常見原因不限
建議的處理提示請確認 adwords_redirect 欄位的值為有效網址。
預防秘訣不限
[item] auth/frontend/not_claimed
摘要尚未在 Merchant Center 中聲明商家網站網址的擁有權。
常見原因不限
建議的處理提示請前往 Merchant Center 聲明該網址的擁有權。如需詳細的建立程序，請參閱說明中心。
預防秘訣不限
[energy_efficiency_class] validation/feed
摘要為同一項產品同時指定 energyEfficiencyClass 和 單價。
常見原因不限
建議的處理提示您只能指定能源效率等級或計價單位，無法同時指定兩者。
預防秘訣不限
[item] internal
摘要發生內部錯誤。
常見原因不限
建議的處理提示重試要求。 如果問題持續發生，請與我們聯絡。
預防秘訣不限
[item_group_id] invalid_attribute
摘要提交的商品同時具有 itemGroupId 和多個子類屬性 (顏色、尺寸、圖案或材質) 的值。
常見原因指定商品群組 ID 時，為產品指定多種尺寸。
建議的處理提示請為每個子類屬性的每個值提交不同的產品，例如 size。
預防秘訣不限
[additional_image_link] invalid_attribute
摘要已提交超過 10 個其他圖片連結。
常見原因不限
建議的處理提示將 其他圖片連結的數量限制為 10 個。
預防秘訣不限
[<attribute>] invalid_character
摘要以字串的形式提交品牌、說明或其他屬性，不會使用指定的要求編碼剖析。
常見原因不限
建議的處理提示請查看訊息來找出造成問題的屬性，然後驗證對應值的文字編碼後再重新提交。API 只接受有效的 UTF-8 字元。
預防秘訣不限
[<attribute>] invalid_value
摘要提交的顏色、說明或其他無效屬性。
常見原因不限
建議的處理提示請確認所有屬性都符合動態饋給規格，詳情請參閱「動態饋給規格」說明中心文章。如有全球交易品項識別碼或製造商零件編號問題，請參閱 說明中心文章，瞭解專屬產品 ID。
預防秘訣不限
[<attribute>] missing_recommended / missing_required
摘要提交的產品不含必填/建議屬性。
常見原因不限
建議的處理提示請務必為產品加入所有建議 / 必要屬性。詳情請參閱動態饋給規格說明中心文章。
預防秘訣不限
[link] validation/invalid_value for <destinations>: URLs do not belong to your website
摘要提交產品的基準網址，與 Merchant Center 帳戶已聲明擁有權的網址不同。
常見原因不限
建議的處理提示確認所提交產品的網址與 Merchant Center 聲明擁有權的網站相符。
預防秘訣不限