이 페이지에서는 Merchant API와 관련하여 개발자가 우려하는 사항을 설명합니다.
제품 및 인벤토리 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에 일부 특수문자를 허용하고 있습니다.
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 생태계 전반에서 동작을 표준화하는 솔루션을 출시했습니다. 사전 인코딩된 리소스 이름을 제공하는 새 필드 base64_encoded_name가 API 응답에 추가되어 목록 또는 가져오기 호출의 출력을 수동 인코딩 없이 후속 업데이트의 입력으로 직접 사용할 수 있습니다.
데이터 소스 생성 후 지연
신고일: 2024년 4월 10일(UTC) | 최종 업데이트: 2024년 5월 12일(UTC)
새 DataSource를 만든 직후에 제품, 프로모션 또는 리뷰를 삽입하려고 하면 알려진 지연이 발생합니다. 데이터 소스가 생성된 후 5분 이내에 항목을 삽입하려고 하면 Data source not found 오류가 반환됩니다.
해결됨: 이 지연이 해결되어 새로 생성된 데이터 소스와 더 즉각적으로 상호작용할 수 있습니다.
다른 문제가 있나요?
다른 문제가 있는 경우 Merchant API 관련 도움 받기 및 의견 보내기 페이지를 참고하세요.