이 페이지에서는 Merchant API와 관련된 알려진 개발자 문제를 설명합니다.
UnauthenticatedException 무작위 오류
보고됨: 2026년 3월 30일(UTC) | 최종 업데이트: 2026년 4월 17일(UTC)
여러 고객에게 제품을 업로드하고 다른 판매자 센터 API에 액세스할 때 간헐적으로 UnauthenticatedException 오류가 발생합니다.
오류는 재시도해도 무작위로 발생하며 초기 호출과 후속 시도 모두에 영향을 미칩니다. 일부 연결은 실패하는 반면 다른 연결은 짧은 시간 내에 성공합니다.
완화 조치가 배포되었으며 영구적인 해결 방법을 조사 중입니다. 이 오류가 발생하면 API 호출을 다시 시도하는 것이 좋습니다.
제품 및 인벤토리 메서드의 지연 시간 증가, DEADLINE_EXCEEDED, INTERNAL_ERROR 메시지
보고됨: 2026년 3월 18일(UTC) | 최종 업데이트: 2026년 5월 13일(UTC)
일부 사용자는 productInputs 및 regionalInventories 메서드를 사용할 때 지속적인 지연 시간과 DEADLINE_EXCEEDED 또는 INTERNAL_ERROR 메시지가 자주 표시되는 문제를 경험했습니다. 주요 원인은 처리 효율성에 영향을 미치는 백엔드 수준의 인시던트로 확인되었습니다. 이 문제를 해결하기 위한 노력은 계속되고 있습니다.
지연 시간이 계속 길어지면 요청 일괄 처리 크기를 줄이는 것이 좋습니다. 앞서 언급한 오류 메시지가 표시되면 클라이언트 측 제한 시간을 늘려 보세요.
제품 및 인벤토리 insert 메서드의 처리량 문제
보고됨: 2026년 1월 28일(UTC) | 최종 업데이트: 2026년 3월 31일(UTC)
판매자 API로 많은 양의 데이터를 전송하는 동안 처리량과 관련된 클라이언트 측 성능 문제가 보고되었습니다. 다음 메서드에 클라이언트 라이브러리를 사용할 때 이 문제가 발생할 수 있습니다.
accounts.productInputs.insertaccounts.products.localInventories.insertaccounts.products.regionalInventories.insert
다양한 백엔드 시스템의 성능을 개선했습니다. 이 문제가 계속 발생하면 처리량을 극대화하도록 채널 풀을 구성해야 할 수 있습니다. 이렇게 하면 여러 기본 연결을 관리하여 단일 gRPC 채널의 일반적인 100개 스트림 제한을 우회할 수 있습니다. 자세한 내용은 동시 요청을 위한 코드 리팩터링: 채널 풀로 처리량 개선을 참고하세요.
특수문자가 포함된 제품 식별자
보고됨: 2025년 10월 3일(UTC) | 최종 업데이트: 2026년 4월 8일(UTC)
productId 또는
offerId가
제품 ID 형식 가이드라인을 준수하지 않는 제품을 관리할 때 문제가 발생할 수 있습니다.
이러한 제품 ID에는 특수문자(특히 슬래시(/), 콜론(:), 물결표(~), 퍼센트 기호(%))가 포함될 수 있습니다. 판매자 센터와 같은 서피스에서는 이미 제품 ID에 일부 특수문자를 허용하고 있습니다.
판매자 API는 제품 식별자를 URL의 일부로 리소스 name (예: accounts/{account}/products/{productId})에 직접 통합하므로 이러한 문자는 표준 URL 라우팅 및 파싱을 방해하여 GET, PATCH 또는 DELETE 작업 중에 예기치 않은 404 Not Found 또는 400 Bad Request 오류를 일으킬 수 있습니다.
이러한 문자가 포함된 제품과 안전하게 상호작용하려면 리소스 이름의 productId 또는 offerId 세그먼트를 인코딩해야 합니다. 인코딩 알고리즘은 패딩이 없는 Base64URL 인코딩 입니다. 자세한 내용은
accounts.productInputs.name을 참고하세요.
해결됨: 판매자 API 생태계 전반에서 동작을 표준화하는 솔루션을 출시했습니다. 수동 인코딩을 실행하지 않고도 목록 또는 가져오기 호출의 출력을 후속 업데이트의 입력으로 직접 사용할 수 있도록 사전 인코딩된 리소스 이름을 제공하는 새 필드 base64_encoded_name을 API 응답에 추가했습니다.
데이터 소스 생성 후 지연
보고됨: 2024년 4월 10일(UTC) | 최종 업데이트: 2024년 5월 12일(UTC)
새 DataSource를 만든 직후 제품, 프로모션 또는 리뷰를 삽입하려고 할 때 알려진 지연이 발생했습니다. 데이터 소스가 생성된 후 5분 이내에 항목을 삽입하려고 하면 Data source not found 오류가 반환되었습니다.
해결됨: 이 지연이 제거되어 새로 생성된 데이터 소스와 더 즉각적으로 상호작용할 수 있습니다.
다른 문제가 있나요?
다른 문제가 있으면 판매자 API 관련 도움말 보기 및 의견 제공 페이지로 이동하세요.