常見錯誤

以下是常見錯誤：

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

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 要求大小限制。
常見原因每個 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 要求的數量。
預防秘訣收到這項錯誤時，請使用批次處理和程式輔助的輪詢策略，將要求率降至適當的可持續水平。

驗證

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