지연 시간은 요청에 대한 응답을 받을 때까지 걸리는 시간입니다. 이 가이드에서는 Merchant API 요청의 지연 시간 규모를 설명합니다. 이러한 값을 사용하여 제한 시간을 설정하고 통합 처리량을 계획합니다.
대부분의 Merchant API 요청은 1초 이내에 완료됩니다. 로컬 및 리전 인벤토리 업데이트에는 몇 초 정도 걸릴 수 있으며 일부 보고서 쿼리는 훨씬 더 오래 걸립니다.
일반적인 지연 시간
다음 표에는 요청 유형별 대략적인 지연 시간이 나와 있습니다. 일반적인 지연 시간은 중앙값입니다. 요청의 절반이 더 빠르게 완료됩니다. 요청의 가장 느린 1%는 마지막 열에 표시된 시간만큼 또는 그보다 오래 걸립니다.
| 요청 유형 | 메서드 예시 | 일반 지연 시간 | 가장 느린 요청 1% |
|---|---|---|---|
| 제품 읽기 및 쓰기 | products.get, productInputs.insert, productInputs.patch, productInputs.delete |
100~600밀리초 | 약 2초 |
| 대부분의 기타 요청 | products.list, accounts.get, dataSources.list, aggregateProductStatuses.list |
1초 미만 | 몇 초 |
| 로컬 및 리전 인벤토리 쓰기 | localInventories.insert, regionalInventories.insert 및 해당 delete 메서드 |
몇 초 | 10초 이상 |
| 보고서 검색어 | accounts.reports.search |
약 0.5초 | 30초 이상 |
보고서 쿼리는 가장 다양합니다. 지연 시간은 쿼리하는 보고서 표와 쿼리가 처리하는 데이터 양에 따라 달라집니다. 보고서 쿼리 10개 중 약 1개는 일반적으로 2초 이상 걸리며, 일부는 1분 이상 걸릴 수 있습니다.
추천
- 여유 시간을 두고 제한 시간을 설정합니다. 클라이언트에서 요청 제한 시간을 설정하는 경우 일반적인 지연 시간에 나열된 가장 느린 지연 시간보다 훨씬 높게 설정합니다. 예를 들어 60초 제한 시간은 대부분의 요청에 충분한 여유를 제공하지만 모든 보고서 쿼리에 충분하지는 않습니다.
- 독립적인 요청을 동시에 전송합니다. 인벤토리 쓰기에는 각각 몇 초가 걸리므로 하나씩 차례로 전송하면 처리량이 제한됩니다. 독립적인 요청을 동시에 전송하거나 일괄 요청을 사용합니다. 여러 요청을 보낼 때는 분당 및 일일 한도에 유의하세요. 자세한 내용은 비율 할당량을 참조하세요.
- 보고서 쿼리를 필요한 데이터로 제한합니다. 긴 기간과 같은 대규모 데이터 세트를 포함하는 쿼리는 시간이 더 오래 걸리고 시간 초과될 수 있습니다. 대량의 데이터가 필요한 경우 BigQuery를 사용하는 것이 좋습니다. 자세한 내용은 BigQuery에 Google 판매자 센터 데이터 로드를 참조하세요.
- 지수 백오프로 다시 시도합니다. 요청이 시간 초과되거나 일시적인 오류로 인해 실패하면 지수 백오프로 다시 시도합니다.
처리 시간
데이터를 변경하는 요청의 경우 성공 응답은 Merchant API가 변경사항을 수락했음을 의미하지만 응답 후에도 처리가 계속됩니다. 처리 시간은 응답부터 다른 리소스에 변경사항이 표시될 때까지의 시간입니다. 처리 시간은 지연 시간에 포함되지 않으며 훨씬 더 길어질 수 있습니다. 예를 들어 처리된 제품에 삽입된 제품 입력이 반영되는 데 몇 분 정도 걸릴 수 있습니다.
데이터의 최종 처리 상태에 대한 자세한 내용은 다음 가이드를 참조하세요.