Bắt đầu sử dụng API Merchant

Bật Merchant API trong dự án trên Google Cloud để bắt đầu.

Sau đây là cách sử dụng Merchant API:

Dùng thư viện ứng dụng

Merchant API được tạo từ nhiều API phụ.

Mỗi API phụ có mã mẫu và thư viện ứng dụng để giúp bạn bắt đầu.

Nếu bạn đã sử dụng Content API for Shopping, hãy xem phần Khả năng tương thích của Content API for Shopping.

Gửi yêu cầu

Merchant API sử dụng tên tài nguyên thay vì mã nhận dạng để nhận dạng. Ví dụ: tên tài nguyên của một sản phẩm có thể là accounts/123/products/online~en~US~sku123, trong đó 123 là giá trị nhận dạng duy nhất của tài khoản và online~en~US~sku123 là giá trị nhận dạng duy nhất của sản phẩm.

Để thao tác trên một tài nguyên, hãy gửi yêu cầu đến URL theo định dạng sau:

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

Lưu ý: Phần :{method} bị bỏ qua đối với các phương thức tiêu chuẩn.

Ví dụ: yêu cầu này sẽ xoá kho hàng theo khu vực:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123/products/online~en~US~sku123/regionalInventories/456

Để tạo một tài nguyên mới, bạn có thể sử dụng tên tài nguyên của tài nguyên mẹ và URL sau

POST https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name of parent}/{resource}

Ví dụ: đây là cách bạn tạo một khu vực mới cho account/123

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123/regions

Hãy xem tài liệu tham khảo về Merchant API để biết thêm thông tin chi tiết về các dịch vụ cụ thể.

Sử dụng gRPC hoặc REST

Merchant API hỗ trợ gRPC và REST. Sau đây là hai cách để thực hiện lệnh gọi Merchant API:

gRPC (nên dùng)	Kiến trúc chuyển trạng thái đại diện (REST)
Tạo nội dung của yêu cầu dưới dạng vùng đệm giao thức. Gửi nội dung yêu cầu đến máy chủ bằng HTTP/2. Giải tuần tự phản hồi đến vùng đệm giao thức. Diễn giải kết quả.	Tạo phần nội dung yêu cầu dưới dạng đối tượng JSON. Gửi thông tin đó đến máy chủ bằng HTTP 1.1. Giải tuần tự phản hồi dưới dạng đối tượng JSON. Diễn giải kết quả.

Lưu ý: Nếu bạn sử dụng thư viện ứng dụng thì cơ chế truyền tải mặc định sẽ là gRPC. Trong hầu hết các trường hợp, bạn không cần làm gì ngoài việc gọi các điểm cuối API Merchant để sử dụng gRPC.

Nhận trợ giúp

Để biết thông tin về cách yêu cầu hỗ trợ, hãy xem Nhận trợ giúp về Merchant API.

Gửi ý kiến phản hồi

Giai đoạn beta là cơ hội để chúng tôi thu thập và giải quyết ý kiến phản hồi của bạn trước khi phát hành rộng rãi. Để gửi ý kiến phản hồi, hãy gửi một trong những nội dung sau:

• Tính năng API: Gửi biểu mẫu phản hồi
• Tài liệu: Sử dụng tính năng đánh giá bằng hình thu nhỏ trong trang và nút Gửi ý kiến phản hồi.
• Mẫu và thư viện: Sử dụng nút Vấn đề mới trên GitHub.

Để đưa ra ý kiến phản hồi chung sau khi triển khai từng nhiệm vụ, hãy sử dụng biểu mẫu phản hồi.