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 duy nhất.

Nếu bạn muốn thực hiện việc tạo yêu cầu 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 theo lô 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 đã 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.

Sau đây là một số ví dụ về lý do bạn nên xử lý hàng loạt các yêu cầu:

• Bạn vừa bắt đầu sử dụng API và có nhiều dữ liệu cần tải lên.
• Người dùng đã thay đổi dữ liệu 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, từ đó cải thiện thời gian phản hồi của máy chủ và giảm độ trễ.

Lưu ý: Để đạt được hiệu suất tối ưu cho các tác vụ có thông lượng cao như cập nhật sản phẩm hoặc khoảng không quảng cáo, bạn nên bắt đầu với quy mô lô vừa phải, sau đó điều chỉnh quy mô dựa trên hạn mức API của mình. Để biết hạn mức cụ thể của API, hãy xem phần Hạn mức và giới hạn

Lưu ý: Việc yêu cầu theo lô không làm giảm số lượt sử dụng của bạn. Nếu một lô có N yêu cầu riêng lẻ, thì lô đó sẽ được tính là N yêu cầu trong hạn mức của bạn.

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

Sau đây là yêu cầu mẫu theo lô 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 tại khu vực của một sản phẩm và một yêu cầu insert để cập nhật kho hàng tại khu vực của cùng một sản phẩm. Bạn phải tuân thủ chính xác đị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 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. Đừng thêm URL cơ sở vào từng yêu cầu riêng lẻ được lồng.
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 đặt hàng

• 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 từng yêu cầu.
• Nếu bạn 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

Sau đây là ví dụ về một 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--
'