常見錯誤

以下是最常見的錯誤：

以下為錯誤清單 (按字母順序排列)。

「auth/account_access_denied」

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

衝突

[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 後端發生問題。
常見原因NA
建議處理提示重試要求。 如果這個問題持續發生，請前往論壇告訴我們。
預防秘訣NA

無效

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

notFound

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

not_inserted

The item could not be inserted.
摘要基於其他錯誤，系統無法插入產品，因為這會覆寫現有的良好項目。
常見原因NA
建議處理提示請先檢查相同呼叫的其他錯誤並解決這些錯誤，然後再嘗試重新插入新的產品資訊。
預防秘訣NA

quota

too_many_items: Merchant quota exceeded
摘要上傳到 Google 購物的商品過多。
常見原因如果產品未通過驗證，但未取代現有的有效產品，系統還是可以插入該產品。建議您為 Productstatuses.list 使用 includeInvalidInsertedItems 標記，確保帳戶沒有過多無效產品。
建議處理提示

請檢查並移除上方提及的過多無效產品，並加以移除。此外，在上傳產品時，請指定 到期日。超過到期日後，系統就會自動刪除產品。請注意，預設的有效期限為產品插入或更新後 30 天。

注意事項：系統會依據所有子帳戶的產品總數檢查多重客戶帳戶的項目配額。如果在子帳戶中收到這個錯誤，請確認子帳戶和 MCA 都有足夠的產品配額。

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

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

刪除過時的子帳戶。

如果所有帳戶都有效，您可以 要求在 MCA 中建立其他子帳戶。

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