常見錯誤

常見錯誤如下：

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

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 購物的商品過多。
常見原因如果產品未通過驗證，但不會取代現有的有效產品，仍可插入。不妨使用 includeInvalidInsertedItems 標記 Productstatuses.list，確保帳戶中無效產品數量不會過多。
建議的處理方式

如上所述，檢查並移除過多的無效產品。此外，上傳產品時請指定 到期日。到期後，產品就會自動刪除。請注意，產品插入或更新後，預設和最長有效期限為 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 要求大小限制。
常見原因每個 entries 請求最多可包含 10,000 個 custombatch，壓縮後的傳輸大小上限為 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 要求數量。
預防秘訣收到這項錯誤時，請使用批次處理和程式輔助輪詢策略，將要求率降低至適當的持續性層級。

驗證

[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 聲明的網站相符。
預防秘訣不適用