가장 일반적인 오류는 다음과 같습니다.
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> |
|
---|---|
요약 | 충돌하는 여러 작업을 동시에 시도했습니다. |
일반적인 원인 | 단일 일괄 요청에 동일한 제품에 대한 여러 개의 충돌하는 작업이 포함되어 있거나 동일한 제품에 대한 여러 개의 충돌하는 작업이 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' |
|
요약 | 인벤토리 피드를 통해 온라인 제품의 가격과 재고를 업데이트하려고 했지만 URL에서 특수 값 online 이외의 값을 매장 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. |
|
---|---|
요약 | 기타 오류로 인해 기존의 정상 항목을 덮어쓰므로 제품을 삽입할 수 없습니다. |
일반적인 원인 | 북미 |
권장 해결 방법 | 동일한 호출의 다른 오류를 확인하고 해결한 후 새 제품 정보를 다시 삽입하세요. |
예방법 | 북미 |
quota
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 |
|
요약 | 지정된 서비스 메서드에 허용되는 일일 요청 수를 초과합니다. |
일반적인 원인 | 게시 한도에 나열된 일일 할당량을 참조하세요. 이러한 기준을 초과하면 이 오류가 발생합니다. |
권장 해결 방법 | 가능하면 여러 변경사항을 단일 요청으로 통합하여 일일 전송되는 총 요청을 줄이세요. 제품을 여러 번 빠르게 변경하지 않도록 적절한 기간 동안 제품 변경을 일괄 처리하는 것이 좋습니다. 웹사이트에서 마이크로데이터로 표시될 수 있는 항목 업데이트의 경우 이 접근 방식을 사용하여 특정 메서드의 일일 호출이 더 필요한 경우 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를 지정할 때 제품의 사이즈를 두 개 이상 지정하는 경우 |
권장 해결 방법 | 지정된 옵션 속성의 값마다 다른 제품을 제출하세요(예:
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이 판매자 센터에서 소유권을 주장한 웹사이트와 일치하는지 확인합니다. |
예방법 | 북미 |