일반적인 오류

가장 흔한 오류는 다음과 같습니다.

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

다음은 오류 목록을 알파벳순으로 정렬한 것입니다.

auth/account_access_denied

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>
요약	동시에 충돌하는 여러 작업을 시도했습니다.
일반적인 원인	단일 일괄 요청에 동일한 제품에 대한 충돌하는 작업이 여러 개 포함되어 있거나 동일한 제품에 대한 충돌하는 작업이 여러 개 콘텐츠 API에 동시에 제출되었습니다.
권장 처리 팁	예방 팁을 참고하세요.
예방법	일괄 처리된 요청 집합의 단일 작업에 지정된 제품의 모든 변경사항을 포함합니다. 동일한 판매자 및 스토어 코드에 대해 Content API를 동시에 여러 번 호출하지 않거나 이러한 호출에 중복된 제품이 포함되지 않도록 하세요.

internalError

Internal error
요약	Google 백엔드에 문제가 있습니다.
일반적인 원인	해당 없음
권장 처리 팁	요청을 다시 시도하세요. 계속 실패하는 경우 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'
요약	인벤토리 피드를 통해 온라인 제품의 가격과 재고를 업데이트하려고 했지만 URL에 특수 값 online이 아닌 다른 값을 판매점 ID로 지정했습니다.
일반적인 원인	해당 없음
권장 처리 팁	요청 URL에서 스토어 ID를 online로 변경합니다.
예방법	모든 인벤토리 쿼리에서 온라인 제품의 경우 online를, 오프라인 제품의 경우 매장 ID를 지정해야 합니다.
[<attribute>]
요약	대괄호 안에 지정된 항목이 유효하지 않습니다.
일반적인 원인	해당 없음
권장 처리 팁	문제 상품의 사양을 수정합니다. 자세한 내용은 피드 사양 고객센터 도움말을 참고하세요.
예방법	해당 없음

notFound

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

not_inserted

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

인용구

too_many_items: Merchant quota exceeded
요약	Google 쇼핑에 너무 많은 상품이 업로드되었습니다.
일반적인 원인	유효성 검사에 실패한 제품은 기존의 유효한 제품을 대체하지 않는 경우 삽입될 수 있습니다. includeInvalidInsertedItems 플래그를 사용하여 Productstatuses.list 계정에 무효 제품이 지나치게 많지 않은지 확인하세요.
권장 처리 팁	위에서 설명한 대로 잘못된 제품이 지나치게 많지 않은지 확인하고 삭제합니다. 또한 제품을 업로드할 때 만료일을 지정합니다. 만료일이 되면 제품이 자동으로 삭제됩니다. 기본 및 최대 만료일은 제품 삽입 또는 업데이트 후 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 요청 수가 줄어듭니다.
예방법	이 오류가 표시되면 일괄 처리 및 프로그래매틱 백오프 전략을 사용하여 요청 비율을 적절한 지속 가능한 수준으로 줄이세요.

validation

[adwords_redirect]
요약	adwords_redirect 필드가 유효한 URL이 아닌 제품을 제출했습니다.
일반적인 원인	해당 없음
권장 처리 팁	adwords_redirect 필드의 값이 유효한 URL인지 확인합니다.
예방법	해당 없음
[item] auth/frontend/not_claimed
요약	판매자의 웹사이트 URL이 판매자 센터에서 소유권이 주장되지 않았습니다.
일반적인 원인	해당 없음
권장 처리 팁	판매자 센터에서 URL을 소유권 주장합니다. 자세한 절차는 고객센터에서 확인할 수 있습니다.
예방법	해당 없음
[energy_efficiency_class] validation/feed
요약	동일한 제품에 대해 energyEfficiencyClass와 단가를 모두 지정했습니다.
일반적인 원인	해당 없음
권장 처리 팁	에너지 효율 등급 또는 단가 책정만 지정하고 둘 다 지정하지는 마세요.
예방법	해당 없음
[item] internal
요약	내부 오류가 발생했습니다.
일반적인 원인	해당 없음
권장 처리 팁	요청을 다시 시도하세요. 계속 실패하는 경우 Google에 문의하세요.
예방법	해당 없음
[item_group_id] invalid_attribute
요약	itemGroupId와 옵션 속성 (색상, 사이즈, 패턴 또는 소재)의 여러 값을 모두 사용하여 상품을 제출했습니다.
일반적인 원인	상품 그룹 ID를 지정하면서 제품의 사이즈를 두 개 이상 지정하는 경우
권장 처리 팁	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이 판매자 센터에서 소유권을 주장한 웹사이트와 일치하는지 확인합니다.
예방법	해당 없음