존재하지 않는 제품을 삭제하려고 하거나 삭제할 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의 제품 할당량이 모두 충분한지 확인하세요.
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 요청 수가 줄어듭니다.
예방법
이 오류가 발생하면 일괄 처리 및 프로그래매틱 백오프 전략을 사용하여 요청 비율을 지속 가능한 적절한 수준으로 줄입니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2024-07-03(UTC)"],[[["This guide outlines common errors when using the Google Merchant API, categorized for easier understanding."],["Errors can relate to authentication, data conflicts, invalid data, missing information, or exceeding usage limits."],["Solutions include verifying user permissions, correcting product data, and adjusting request frequency."],["Refer to linked resources for detailed specifications, usage limits, and account management."],["This guide aids in troubleshooting and preventing common issues when interacting with the Google Merchant API."]]],[]]
