Gửi nhiều yêu cầu cùng một lúc

Bạn có thể sử dụng yêu cầu hàng loạt với Merchant API để gửi nhiều yêu cầu HTTP trong một lệnh gọi API.

Nếu bạn muốn thực hiện việc nhóm hàng loạt bằng thư viện ứng dụng, hãy xem bài viết Tái cấu trúc mã cho các yêu cầu đồng thời.

Yêu cầu hàng loạt là một yêu cầu HTTP tiêu chuẩn duy nhất chứa nhiều lệnh gọi API, sử dụng loại nội dung multipart/mixed. Trong yêu cầu HTTP chính, mỗi phần chứa một yêu cầu HTTP lồng nhau.

Bạn có thể gửi yêu cầu hàng loạt đến batchPath được chỉ định cho API. batchPath cho Merchant API là batch/{sub-api}/v1. Bạn có thể tìm thấy batchPath cho các API khác trong tài liệu khám phá của chúng.

Dưới đây là một số lý do để nhóm các yêu cầu của bạn:

  • Bạn vừa bắt đầu sử dụng API và có nhiều dữ liệu cần tải lên.
  • Một người dùng đã thay đổi dữ liệu trong khi ứng dụng của bạn đang ở chế độ ngoại tuyến và ứng dụng của bạn cần đồng bộ hoá dữ liệu cục bộ với máy chủ.

Việc gửi nhiều yêu cầu song song giúp bạn không phải chờ yêu cầu phụ chậm nhất, nhờ đó cải thiện thời gian phản hồi của máy chủ và giảm độ trễ.

Viết yêu cầu hàng loạt

Dưới đây là yêu cầu hàng loạt mẫu của Merchant API. Yêu cầu này kết hợp một yêu cầu get để truy xuất kho hàng theo khu vực cho một sản phẩm và một yêu cầu insert để cập nhật kho hàng theo khu vực cho cùng một sản phẩm. Bạn phải tuân theo đúng định dạng của ví dụ:

  1. Sử dụng https://merchantapi.googleapis.com/batch/{sub-api}/v1 làm URL cơ sở.
  2. Chỉ định một ranh giới để phân tách từng yêu cầu lồng nhau, ví dụ: -H 'Content-Type: multipart/mixed,boundary=batch_inventory' \
  3. Phân tách từng yêu cầu lồng nhau bằng ranh giới, ví dụ: --batch_inventory.
  4. Thêm Content-Type: application/http vào đầu mỗi yêu cầu lồng nhau.
  5. Sử dụng Content-ID để gắn nhãn cho từng yêu cầu lồng nhau bằng mã nhận dạng của riêng bạn. Ví dụ: Content-ID: <get~en~US~123456>.
  6. Thêm một dòng trống giữa tiêu đề, đường dẫn và nội dung của mỗi yêu cầu lồng nhau. Nếu yêu cầu lồng nhau không có nội dung, hãy để một dòng trống trước ranh giới tiếp theo.
  7. Không thêm URL cơ sở vào từng yêu cầu lồng nhau riêng lẻ.
  8. Kết thúc yêu cầu chính bằng một ranh giới cuối cùng, ví dụ: --batch_inventory–.
curl https://merchantapi.googleapis.com/batch/inventories/v1 \
-H 'Authorization: Bearer <TOKEN>' \
-H 'Content-Type: multipart/mixed,boundary=batch_inventory' \
--data '
--batch_inventory
Content-Type: application/http
Content-ID: <get:online:en:US:123456>
GET /inventories/v1/accounts/123/products/online:en:US:123456/regionalInventories
--batch_inventory
Content-Type: application/http
Content-ID: <post:online:en:US:123456>
POST /inventories/v1/accounts/123/products/online:en:US:123456/regionalInventories:insert
{
   "region: "123456",
    "price": {
        "amountMicros": "100000000",
        "currencyCode": "USD"
    }
}
--batch_inventory--
'

Lưu ý về việc sắp xếp

  • Các yêu cầu có thể không thực thi theo thứ tự mà bạn chỉ định.
  • Sử dụng Content-ID để xác định các yêu cầu riêng lẻ.
  • Nếu cần thực thi các lệnh gọi theo một thứ tự nhất định, hãy gửi riêng từng lệnh gọi và đợi phản hồi cho yêu cầu đầu tiên trước khi gửi yêu cầu tiếp theo.

Đọc phản hồi hàng loạt

Dưới đây là ví dụ về phản hồi hàng loạt HTTP. Thứ tự của các phản hồi có thể không khớp với thứ tự của các yêu cầu. Sử dụng Content-ID để xác định yêu cầu lồng nhau mà mỗi phản hồi lồng nhau thuộc về. Trong các phản hồi, API sẽ thêm tiền tố response- vào mỗi Content-ID.

--batch_inventory
Content-Type: application/http
Content-ID: <response-get~en~US~123456>
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Vary: Origin
Vary: X-Origin
Vary: Referer
{}
--batch_inventory
Content-Type: application/http
Content-ID: <response-post~en~US~123456>
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Vary: Origin
Vary: X-Origin
Vary: Referer
{
  "name": "accounts/123/products/en~US~123456/regionalInventories/123456",
  "region": "123456",
  "price": {
    "amountMicros": "100000000",
    "currencyCode": "USD"
  }
}
--batch_inventory--
'