custombatch는 '항목'이라고 하는 여러 API 호출을 단일 HTTP 요청으로 그룹화할 수 있는 일반적인 메서드입니다. 각 항목은 단일 메서드 호출만 참조합니다.
커스텀 배치는 다음과 같은 경우에 적합합니다.
- API를 막 사용하기 시작했고 업로드할 제품 데이터가 많다면
- 많은 업데이트 및 삭제를 전송하여 로컬 데이터를 서버와 동기화해야 합니다.
일괄 요청
일괄 요청을 전송하는 것은 API 호출을 동시에 전송하는 것과 유사합니다. 요청에 정의된 항목의 순서가 실행된 순서와 같지 않을 수도 있습니다. 단일 일괄 요청에서 상호 의존적인 호출을 사용하지 않는 것이 좋습니다 (예: 동일한 배송 생성 및 업데이트).
마찬가지로 일괄 요청에 대해 수신된 응답은 요청 항목의 응답 순서와 다른 순서로 반환될 수 있습니다. 응답이 순서대로 반환될 수 있으므로 BatchId를 사용하여 요청과 응답의 상관관계를 지정할 수 있습니다.
적절한 custombatch 메서드를 호출하여 API에서 요청을 일괄 처리할 수 있습니다.
| 리소스 및 해당 커스텀 일괄 메서드 | |
|---|---|
Accounts |
accounts.custombatch |
Accountstatuses |
accountstatuses.custombatch |
Accounttax |
accounttax.custombatch |
Datafeeds |
datafeeds.custombatch |
Datafeedstatuses |
datafeedstatuses.custombatch |
Localinventory |
localinventory.custombatch
|
Liasettings |
liasettings.custombatch |
Pos |
pos.custombatch |
Products |
products.custombatch |
Productstatuses |
productstatuses.custombatch |
Shippingsettings |
shippingsettings.custombatch |
한도
대규모 배치를 업로드할 때 오류를 방지하려면 custombatch 요청의 크기를 최대 1,000개 항목으로 제한하는 것이 좋습니다. custombatch 요청에는 다음 최댓값이 적용됩니다.
custombatch요청당 항목 50,000개- 전송 크기 32MB
최댓값을 초과하면 다음과 같은 request_too_large 오류가 발생합니다.
"Too many requests in a batch.""Request payload size exceeds the limit: %d bytes."