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