알려진 문제

이 페이지에서는 Merchant API와 관련하여 개발자가 알고 있어야 하는 사항을 설명합니다.

UnauthenticatedException 무작위 오류

신고일: 2026년 3월 30일(UTC)

제품을 업로드하고 다른 판매자 센터 API에 액세스할 때 여러 고객에게 간헐적으로 UnauthenticatedException 오류가 발생합니다. 오류는 재시도해도 무작위로 발생하며 초기 호출과 후속 시도 모두에 영향을 미칩니다. 일부 연결은 실패하지만 다른 연결은 짧은 시간 내에 성공합니다.

현재 해결 방법이나 권장사항이 없습니다.

제품 및 인벤토리 메서드의 지연 시간 증가, DEADLINE_EXCEEDED, INTERNAL_ERROR 메시지

신고: 2026년 3월 18일(UTC) | 해결: 2026년 3월 31일(UTC)

일부 사용자는 productInputs 및 regionalInventories 메서드를 사용할 때 지속적인 지연 시간과 빈번한 DEADLINE_EXCEEDED 또는 INTERNAL_ERROR 메시지가 표시되었습니다. 주요 원인은 처리 효율성에 영향을 미치는 백엔드 수준 문제인 것으로 확인되었습니다.

해결: 이 문제는 2026년 3월 31일에 완전히 해결되었습니다. 완화 조치 후 오류율이 크게 감소했습니다. 지연 시간이 계속 길어지면 클라이언트 측 제한 시간을 확인하고 요청 배치 크기를 줄이는 것이 좋습니다.

제품 및 인벤토리 insert 메서드의 처리량 문제

신고일: 2026년 1월 28일(UTC) | 최종 업데이트: 2026년 3월 31일(UTC)

판매자 API에 많은 양의 데이터를 전송하는 동안 처리량과 관련된 클라이언트 측 성능 문제가 보고되었습니다. 다음 메서드의 클라이언트 라이브러리를 사용할 때 이 문제가 발생할 수 있습니다.

다양한 백엔드 시스템의 성능을 높이기 위해 개선되었습니다. 이 문제가 계속 발생하면 처리량을 최대화하기 위해 채널 풀을 구성해야 할 수 있습니다. 이렇게 하면 여러 기본 연결을 관리하여 단일 gRPC 채널의 일반적인 100개 스트림 제한을 우회할 수 있습니다. 자세한 내용은 동시 요청을 위한 코드 리팩터링: 채널 풀로 처리량 개선을 참고하세요.

특수 문자가 포함된 제품 식별자

신고일: 2025년 10월 3일(UTC) | 최종 업데이트: 2026년 4월 8일(UTC)

productId 또는 offerId이 제품 ID 형식 가이드라인을 준수하지 않는 제품을 관리할 때 문제가 발생할 수 있습니다. 이러한 제품 ID에는 특수 문자(특히 슬래시(/), 콜론(:), 물결표(~), 퍼센트 기호(%))가 포함될 수 있습니다. 판매자 센터와 같은 플랫폼에서는 이미 제품 ID에 일부 특수 문자를 허용하고 있습니다.

Merchant 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 오류가 반환됩니다.

해결됨: 이 지연이 해결되어 새로 생성된 데이터 소스와 더 즉각적으로 상호작용할 수 있습니다.

다른 문제가 있나요?

기타 문제에 대해서는 Merchant API 관련 도움 받기 및 의견 보내기 페이지를 참고하세요.