常見錯誤
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
以下是最常見的錯誤:
以下為錯誤清單 (按字母順序排列)。
「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 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2023-12-02 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]