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."