이 페이지에서는 Merchant API와 관련하여 개발자가 알아야 할 알려진 문제를 설명합니다.
제품 및 인벤토리 insert 메서드의 처리량 문제
보고일: 2026년 1월 28일(UTC) | 최종 업데이트: 2026년 3월 31일(UTC)
Merchant 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에 일부 특수문자를 허용하고 있습니다.
Merchant API는 제품 식별자를 URL의 일부로 리소스 name에 직접 통합하므로 (예: accounts/{account}/products/{productId}) 이러한 문자가 표준 URL 라우팅 및 파싱을 방해하여 GET, PATCH 또는 DELETE 작업 중에 예기치 않은 404 Not Found 또는 400 Bad Request 오류가 발생할 수 있습니다.
이러한 문자가 포함된 제품과 안전하게 상호작용하려면 리소스 이름의 productId 또는 offerId 세그먼트를 인코딩해야 합니다. 인코딩 알고리즘은 패딩이 없는 Base64URL 인코딩입니다. 자세한 내용은 accounts.productInputs.name을 참조하세요.
해결됨: Merchant API 생태계 전반에서 동작을 표준화하는 솔루션을 출시했습니다. 사전 인코딩된 리소스 이름을 제공하는 API 응답에 새 필드 base64_encoded_name를 추가했습니다. 이를 통해 수동 인코딩을 수행하지 않고도 목록 또는 가져오기 호출의 출력을 후속 업데이트의 입력으로 직접 사용할 수 있습니다.
데이터 소스 생성 후 지연
신고일: 2024년 4월 10일(UTC) | 최종 업데이트: 2024년 5월 12일(UTC)
새 DataSource를 만든 직후 제품, 프로모션 또는 리뷰를 삽입하려고 할 때 알려진 지연이 발생했습니다. 데이터 소스가 생성된 후 5분 이내에 항목을 삽입하려고 시도하면 Data source not found 오류가 반환되었습니다.
해결됨: 이 지연이 해결되어 새로 만든 데이터 소스와 더 즉각적으로 상호작용할 수 있습니다.
다른 문제가 생겼나요?
다른 문제가 있는 경우 Merchant API 관련 도움받기 및 의견 보내기 페이지로 이동하세요.