존재하지 않는 제품을 삭제하려고 시도하거나 삭제 URL에 제품 ID를 올바르게 지정하지 않았습니다.
권장 처리 도움말
Products.list를 사용하여 제품 목록을 가져오고 여기에 표시되는 항목만 가져오거나 업데이트하거나 삭제하려고 시도합니다. 277104-ekb과 같은 혜택 ID가 아닌 channel:languageCode:countryCode:offerId 형식(예: online:ru:RU:277104-ekb)으로 제품 ID를 지정해야 합니다.
예방법
해당 사항 없음
not_inserted
The item could not be
inserted.
요약
다른 오류로 인해 제품을 삽입할 수 없습니다. 기존의 유효한 항목을 덮어쓸 수 있기 때문입니다.
일반적인 원인
해당 사항 없음
권장 처리 도움말
새 제품 정보를 다시 삽입하기 전에 동일한 호출의 다른 오류를 확인하고 해결합니다.
예방법
해당 사항 없음
인용구
too_many_items: Merchant
quota exceeded
요약
Google 쇼핑에 업로드된 상품이 너무 많습니다.
일반적인 원인
유효성 검사에 실패한 제품이 기존의 유효한 제품을 대체하지 않는 경우에도 삽입될 수 있습니다. includeInvalidInsertedItems 플래그를 사용하여 Productstatuses.list를 실행하여 계정에 잘못된 제품이 너무 많지 않은지 확인해 보세요.
권장 처리 도움말
위에 언급된 대로 잘못된 제품이 과도하게 있는지 확인하고 삭제합니다. 또한 제품을 업로드할 때
만료일을 지정합니다. 만료일이 되면 제품이 자동으로 삭제됩니다. 기본 및 최대 만료일은 제품 삽입 또는 업데이트 후 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"]],["최종 업데이트: 2025-06-19(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."]]],["The document details errors within the Merchant API, which is the future version of the Content API for Shopping. Key errors involve `notFound` (item does not exist), `not_inserted` (cannot insert due to conflicts), and `quota/too_many_items` (exceeded upload limits). Handling involves verifying product IDs, addressing conflicting entries, and managing quotas. Common causes include incorrect IDs, simultaneous conflicting operations, and exceeding item limits. Prevention focuses on formatting product IDs correctly, batching changes, reducing invalid products, and using product expiration dates. Other errors such as account access, internal issues, URL, currency, ID, and missing parameters are covered.\n"]]
