Khả năng tương thích của Content API for Shopping

Bạn có thể làm theo hướng dẫn này để tích hợp Merchant API với cách triển khai Content API for Shopping hiện tại.

Bắt đầu

Xem thiết kế API người bán để biết chi tiết về Merchant API và các API phụ của API đó.

Để bắt đầu sử dụng API Merchant, hãy thay đổi URL yêu cầu của bạn thành các URL sau định dạng:

https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…

Hãy xem hướng dẫn bắt đầu nhanh và tài liệu tham khảo về API Merchant Center để biết thêm thông tin.

Hỗ trợ gRPC

Merchant API hỗ trợ gRPC và REST. Bạn có thể sử dụng gRPC cho API Merchant và REST cho Content API for Shopping ở cùng một vị trí bất cứ lúc nào.

Thư viện ứng dụng Merchant API yêu cầu gRPC.

Xem bài viết sử dụng gRPC để biết thêm của bạn.

Khả năng tương thích

Hướng dẫn này mô tả những thay đổi chung áp dụng cho toàn bộ API Merchant. Xem những hướng dẫn sau đây về những thay đổi đối với các tính năng cụ thể:

• Di chuyển hoạt động quản lý tài khoản
• Di chuyển chế độ cài đặt thông tin vận chuyển
• Quản lý quá trình di chuyển sản phẩm
• Di chuyển hoạt động quản lý nguồn dữ liệu
• Quản lý di chuyển kho hàng
• Di chuyển hoạt động quản lý chương trình khuyến mãi
• Di chuyển quy trình quản lý báo cáo
• Di chuyển hoạt động quản lý nguồn chuyển đổi
• Di chuyển hoạt động quản lý đối tác nguồn cấp dữ liệu địa phương

Merchant API được thiết kế để hoạt động cùng với Content API for Shopping hiện có các tính năng của Google v2.1.

Ví dụ: bạn có thể sử dụng Merchant Inventories API cùng với Khoảng không quảng cáo Content API for Shopping phiên bản 2.1 và Triển khai products. Bạn có thể sử dụng Content API for Shopping để tải một video quảng cáo địa phương mới lên sản phẩm (mà bạn bán tại một cửa hàng địa phương), sau đó sử dụng Merchant Inventories API LocalInventory để quản lý thông tin tại cửa hàng cho sản phẩm đó.

Lưu ý: Chúng tôi không thể đảm bảo khả năng tương thích ngược đầy đủ cho các tính năng tương tự giữa Content API for Shopping và Merchant API do các yếu tố cải tiến thiết kế. Ví dụ: tên trường hoặc khả năng sử dụng phương thức có thể khác nhau đối với cùng một tài nguyên trong Content API for Shopping và Merchant API.

Yêu cầu theo lô (Batch)

Merchant API không hỗ trợ phương thức customBatch được nêu trong Content API for Shopping. Thay vào đó, hãy xem phần Gửi hàng loạt . Nếu bạn sử dụng customBatch và cần tính năng này cho API người bán, hãy cho chúng tôi biết lý do trong ý kiến phản hồi.

Giá trị nhận dạng

Để phù hợp với các nguyên tắc cải thiện API của Google, chúng tôi đã thực hiện một số thay đổi đối với giá trị nhận dạng cho các tài nguyên về Merchant API.

tên thay thế Id

Mọi tài nguyên API Merchant Center đều sử dụng trường name làm giá trị nhận dạng riêng biệt.

Dưới đây là ví dụ về cách sử dụng trường name trong lệnh gọi:

POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert

Trường name mới này được trả về dưới dạng giá trị nhận dạng tài nguyên cho tất cả các giá trị đã đọc và ghi lệnh gọi trong API Merchant.

Giá trị được trả về trong các trường name sử dụng định dạng mã nhận dạng mới.

Lưu ý quan trọng: Bạn nên sử dụng giá trị từ trường name ngay trong thay vì phân tích cú pháp hoặc tạo tên tài nguyên theo cách thủ công để tránh vấn đề.

Ví dụ: triển khai phương thức getName() để truy xuất name từ một và lưu trữ kết quả dưới dạng biến thay vì tạo name từ chính mã người bán và mã tài nguyên.

Định dạng mã nhận dạng mới

Lưu ý: API Merchant sẽ trả về các mã nhận dạng không có giá trị channel cho đến hết tháng 11 Ngày 13 tháng 1 năm 2023. Sau ngày 13 tháng 11, tất cả cuộc gọi sẽ trả về mã tài nguyên đầy đủ. Bạn phải sử dụng mã nhận dạng tài nguyên đầy đủ (bao gồm cả channel) trong các cuộc gọi của bạn muộn nhất vào ngày 1 tháng 2, năm 2024.

Trong API Merchant, mã nhận dạng tài nguyên ở định dạng sau: channel~language~feedLabel~offerId

Tài nguyên Content API đã sử dụng : thay vì ~ giữa mỗi giá trị trong mã nhận dạng: channel:language:feedLabel:offerId

Tất cả lệnh gọi API Merchant đều trả về định dạng mới với ~ giữa các giá trị của thuộc tính Mã nhận dạng. Bạn nên lưu trữ định dạng mới trong phản hồi và sử dụng định dạng đó trong các cuộc gọi trong tương lai.

trường mẹ cho các tài nguyên con

Trong API Merchant, mọi tài nguyên con đều có trường parent. Bạn có thể sử dụng trường parent để chỉ định name của tài nguyên cần chèn phần tử con vào, thay vì truyền toàn bộ tài nguyên mẹ. Bạn cũng có thể sử dụng parent có các phương thức list để liệt kê các tài nguyên con của parent đó.

Ví dụ: để đăng kho hàng tại địa phương cho một sản phẩm nhất định, hãy chỉ định thuộc tính name của sản phẩm trong parent trường cho list . Trong trường hợp này, product đã cho là parent của LocalInventory tài nguyên được trả về.

Loại

Dưới đây là một số loại dữ liệu phổ biến được chia sẻ giữa các API phụ của Merchant API.

Giá

Dưới đây là những thay đổi đối với Price trong gói Merchant Common:

	Content API	API người bán
trường Số tiền	value:string	amountMicros:int64
Trường đơn vị tiền tệ	currency:string	currencyCode:string

Số lượng Price hiện được ghi lại dưới dạng phần triệu, trong đó 1 triệu phần triệu tương đương với đơn vị tiêu chuẩn của đơn vị tiền tệ của bạn.

Trong Content API for Shopping, Price là một số thập phân ở dạng .

Tên trường số tiền đã thay đổi từ value thành amountMicros

Tên trường đơn vị tiền tệ đã thay đổi từ currency thành currencyCode. Chiến lược phát hành đĩa đơn định dạng vẫn là ISO 4217.