존재하지 않는 제품을 삭제하려고 하거나 삭제할 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.
요약
기타 오류로 인해 기존의 정상 항목을 덮어쓰므로 제품을 삽입할 수 없습니다.
일반적인 원인
북미
권장 해결 방법
동일한 호출의 다른 오류를 확인하고 해결한 후 새 제품 정보를 다시 삽입하세요.
예방법
북미
quota
too_many_items: Merchant
quota exceeded
요약
Google 쇼핑에 업로드한 상품이 너무 많습니다.
일반적인 원인
검증에 실패한 제품은 기존의 유효한 제품을 대체하지 않는 경우 계속해서 삽입될 수 있습니다. 계정의 잘못된 제품이 지나치게 많지 않도록 Productstatuses.list에 includeInvalidInsertedItems 플래그를 사용하는 것이 좋습니다.
권장 해결 방법
위에 언급된 잘못된 제품이 과도하게 많은지 확인하고 삭제합니다. 또한 제품을 업로드할 때
만료일을 지정합니다. 만료일에 도달하면 제품이 자동으로 삭제됩니다. 기본값(최대) 만료일은 제품 삽입 또는 업데이트 후 30일입니다.
참고: 멀티 클라이언트 계정의 상품 할당량은 모든 하위 계정의 총 제품 수와 비교하여 확인됩니다. 하위 계정에 이 오류가 발생하면 하위 계정과 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 요청 수가 줄어듭니다.
예방법
이 오류가 발생하면 일괄 처리 및 프로그래매틱 백오프 전략을 사용하여 요청 비율을 지속 가능한 적합한 수준으로 줄이세요.
