일반적인 실수

다음은 가장 일반적인 오류입니다.

• notFound: 항목을 찾을 수 없습니다.
• not_inserted: 항목을 삽입할 수 없습니다.
• [link] validation/invalid_value for <destinations>: 웹사이트에 속하지 않는 URL입니다.
• quota/too_many_items: 판매자 할당량을 초과했습니다.

다음은 알파벳순으로 오류 목록입니다.

인증/계정 액세스 거부됨

User cannot access account <account_number>
요약	인증된 사용자가 액세스할 수 없는 계정을 타겟팅하는 요청을 실행했습니다.
일반적인 원인	대상 판매자 ID에 오류가 있거나 판매자 센터에 사용자를 등록하는 것을 잊어버렸습니다.
권장 처리 팁	올바른 계정을 타겟팅하고 있는지 확인하거나 판매자 센터(설정 > 사용자)에서 본인을 계정 사용자로 등록하세요.
예방법	북아메리카
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입니다. 예: online:en:US:sku123 대신 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가 아닌 다른 값을 URL의 매장 ID로 지정했습니다.
일반적인 원인	북아메리카
권장 처리 팁	요청 URL에서 스토어 ID를 online로 변경합니다.
예방법	모든 인벤토리 쿼리에서 온라인 제품의 경우 online를, 오프라인 제품의 매장 ID를 지정해야 합니다.
[<attribute>]
요약	대괄호에 지정된 항목이 잘못되었습니다.
일반적인 원인	북아메리카
권장 처리 팁	문제 항목의 사양을 수정하세요. 자세한 내용은 피드 사양 고객센터 도움말을 참고하세요.
예방법	북아메리카

notFound

Item not found
요약	가져오기, 업데이트 또는 삭제하려는 항목이 존재하지 않습니다.
일반적인 원인	존재하지 않는 제품을 삭제하려고 하거나 삭제할 URL에 제품 ID를 올바르게 지정하지 않음
권장 처리 팁	Products.list를 사용하여 제품 목록을 가져오고 여기에 표시되는 항목만 가져오기, 업데이트 또는 삭제를 시도합니다. 제품 ID를 channel:languageCode:countryCode:offerId 형식으로 지정해야 합니다(예: 277104-ekb와 같은 혜택 ID가 아닌 online:ru:RU:277104-ekb).
예방법	북아메리카

not_inserted

The item could not be inserted.
요약	기존의 정상 항목을 덮어쓰기 때문에 다른 오류로 인해 제품을 삽입할 수 없습니다.
일반적인 원인	북아메리카
권장 처리 팁	동일한 호출에 대한 다른 오류를 확인하고 해결한 후 새 제품 정보를 다시 삽입해 보세요.
예방법	북아메리카

인용구

too_many_items: Merchant quota exceeded
요약	Google 쇼핑에 업로드된 상품이 너무 많습니다.
일반적인 원인	검증에 실패한 제품은 기존의 유효한 제품을 대체하지 않는 경우 삽입될 수 있습니다. 계정에 잘못된 제품이 너무 많지 않도록 Productstatuses.list에 includeInvalidInsertedItems 플래그를 사용하는 것이 좋습니다.
권장 처리 팁	위에 언급된 잘못된 제품이 있는지 확인하고 삭제하세요. 또한 제품을 업로드할 때 만료일을 지정합니다. 만료일에 도달하면 제품이 자동으로 삭제됩니다. 기본 및 최대 만료일은 제품 삽입 또는 업데이트 후 30일입니다. 참고: 멀티 클라이언트 계정의 상품 할당량은 모든 하위 계정의 총 제품 수와 비교하여 확인됩니다. 하위 계정에서 이 오류가 발생하면 하위 계정과 MCA의 제품 할당량이 모두 충분한지 확인하세요. 이러한 솔루션을 시도했지만 여전히 판매자 센터 계정의 새 제품을 위한 공간이 부족하면 계정에 항목을 더 제출할 수 있는 기능을 요청할 수 있습니다.
예방법	권장되는 처리 팁을 참고하세요.
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 서비스에 대한 호출 수를 제한하는 것이 좋습니다. 여전히 하루에 특정 메서드를 더 많이 호출해야 하는 경우 Google에 문의하여 판매자 센터 ID, 할당량 한도에 도달한 메서드, 이러한 메서드에 필요한 일일 호출 수, 예상 호출 수를 알려 주시면 할당량을 상향 조정할 수 있도록 도와드리겠습니다.
예방법	권장되는 처리 팁을 참고하세요.
too_many_failed_auths: Too many failed authentications.
요약	액세스 권한이 없는 계정에 대해 일괄 요청을 너무 많이 하고 있습니다.
일반적인 원인	삭제된 하위 계정 또는 새로 만든 하위 계정이 제공되기 전에 일괄적으로 요청합니다.
권장 처리 팁	삭제된 하위 계정에 영향을 미치는 호출은 피하세요.
예방법	권장되는 처리 팁을 참고하세요.
request_too_large
요약	일괄 요청당 너무 많은 entries를 전송하거나 custombatch 요청 크기 한도를 초과합니다.
일반적인 원인	custombatch 요청당 최대 10,000개의 entries를 포함할 수 있으며 압축된 전송 크기 한도는 32MB입니다.
권장 처리 팁	배치를 한도 이하의 여러 배치로 분할한 후 다시 시도하세요.
예방법	배치당 항목을 1,000개 이하로 전송하는 것이 좋습니다.

없습니다

[price.value] Required parameter: price.value
요약	값이 없는 가격을 지정했습니다. 예를 들어 { "value": 123, "currency": "USD" } 대신 { "currency": "USD" }를 사용할 수 있습니다.
일반적인 원인	북아메리카
권장 처리 팁	매개변수( price)의 형식이 올바른지 확인합니다. 예를 들어 price에는 두 개의 필수 필드인 value와 currency가 있습니다.
예방법	북아메리카
[product] INSERT request must specify product
요약	"method": "insert"는 있지만 제품은 없는 항목이 포함된 커스텀 일괄 요청을 API에 제출했습니다.
일반적인 원인	메서드를 get 또는 delete로 변경하는 것을 잊어버림
권장 처리 팁	product 필드를 통해 삽입할 제품을 지정합니다.
예방법	insert 메서드를 사용하는 일괄 항목은 제품을 지정하고 get 또는 delete 메서드를 사용하는 일괄 항목은 제품 ID를 지정해야 합니다.
[productId] DELETE request must specify productId
요약	"method": "delete"는 있지만 제품 ID가 없는 항목이 포함된 커스텀 일괄 요청을 API에 제출했습니다.
일반적인 원인	메서드를 insert로 변경하는 것을 잊어버림
권장 처리 팁	productID 필드를 통해 삭제할 제품을 지정합니다.
예방법	insert 메서드를 사용하는 일괄 항목은 제품을 지정하고 get 또는 delete 메서드를 사용하는 일괄 항목은 제품 ID를 지정해야 합니다.

userRateLimitExceeded

User Rate Limit Exceeded
요약	요청이 너무 빨리 이루어지고 있습니다. 요청 빈도를 줄이세요.
일반적인 원인	게시된 한도에 나열된 HTTP 요청 한도를 참조하세요. 이 기준을 초과하면 이 오류가 표시됩니다. 이 문제의 원인이 되는 트래픽이 급증하거나 서버가 더 많은 스레드로 확장되는 경우도 있습니다.
권장 처리 팁	분당 전송되는 총 요청 수를 줄이세요. 동일한 서비스에 대한 여러 메서드 호출을 단일 custombatch 요청으로 일괄 처리하면 수행 중인 HTTP 요청 수가 줄어듭니다.
예방법	이 오류가 발생하면 일괄 처리 및 프로그래매틱 백오프 전략을 사용하여 요청 비율을 지속 가능한 적절한 수준으로 줄입니다.

검증

[adwords_redirect]
요약	adwords_redirect 필드가 유효한 URL이 아닌 제품을 제출했습니다.
일반적인 원인	북아메리카
권장 처리 팁	adwords_redirect 필드의 값이 유효한 URL인지 확인합니다.
예방법	북아메리카
[item] auth/frontend/not_claimed
요약	판매자 센터에서 판매자의 웹사이트 URL의 소유권을 주장하지 않았습니다.
일반적인 원인	북아메리카
권장 처리 팁	판매자 센터에서 URL의 소유권을 주장합니다. 자세한 절차는 고객센터를 참고하세요.
예방법	북아메리카
[energy_efficiency_class] validation/feed
요약	동일한 제품에 energyEfficiencyClass 및 단가 책정을 모두 지정했습니다.
일반적인 원인	북아메리카
권장 처리 팁	에너지 효율 등급 또는 단가만 지정하고 둘 다 지정할 수는 없습니다.
예방법	북아메리카
[item] internal
요약	내부 오류입니다.
일반적인 원인	북아메리카
권장 처리 팁	요청을 다시 시도하세요. 계속 실패하는 경우 문의해 주세요.
예방법	북아메리카
[item_group_id] invalid_attribute
요약	itemGroupId 및 옵션 속성 (색상, 크기, 패턴 또는 소재)의 여러 값을 모두 포함하여 상품을 제출했습니다.
일반적인 원인	상품 그룹 ID를 지정할 때 제품의 크기를 2개 이상 지정하는 경우
권장 처리 팁	지정된 옵션 속성의 값마다 다른 제품을 제출합니다(예: size).
예방법	북아메리카
[additional_image_link] invalid_attribute
요약	추가 이미지 링크를 10개 이상 제출함
일반적인 원인	북아메리카
권장 처리 팁	추가 이미지 링크의 수를 10개로 제한합니다.
예방법	북아메리카
[<attribute>] invalid_character
요약	지정된 요청 인코딩을 사용하여 파싱하지 않는 문자열로 브랜드, 설명 또는 기타 속성을 제출했습니다.
일반적인 원인	북아메리카
권장 처리 팁	메시지를 확인하여 문제를 일으키는 속성을 파악한 다음 다시 제출하기 전에 해당 값의 텍스트 인코딩을 검증하세요. API에서는 유효한 UTF-8 문자만 사용할 수 있습니다.
예방법	북아메리카
[<attribute>] invalid_value
요약	잘못된 색상, 설명 또는 기타 속성을 제출했습니다.
일반적인 원인	북아메리카
권장 처리 팁	모든 속성이 피드 사양을 준수하는지 확인하세요. 자세한 내용은 피드 사양 고객센터 도움말을 참고하세요. GTIN 또는 MPN 문제는 제품 고유 식별자 고객센터 도움말을 참조하세요.
예방법	북아메리카
[<attribute>] missing_recommended / missing_required
요약	필수/권장 속성 없이 제품을 제출했습니다.
일반적인 원인	북아메리카
권장 처리 팁	제품의 모든 권장 / 필수 속성을 포함해야 합니다. 자세한 내용은 피드 사양 고객센터 도움말을 참고하세요.
예방법	북아메리카
[link] validation/invalid_value for <destinations>: URLs do not belong to your website
요약	판매자 센터 계정에서 소유권을 주장한 URL과 기본 URL이 다른 제품을 제출했습니다.
일반적인 원인	북아메리카
권장 처리 팁	제출된 제품의 URL이 판매자 센터에서 소유권을 주장한 웹사이트와 일치하는지 확인합니다.
예방법	북아메리카