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:

Sử dụng thư viện ứng dụng

Merchant API bao gồm 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 chuẩn.

Ví dụ: yêu cầu này sẽ xoá khoảng không quảng cáo 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 vùng 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)	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 mã phản hồi thành vùng đệm giao thức. Diễn giải kết quả.	Tạo 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. Tạo lại 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, 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 bài viết Yêu cầu trợ giúp về Merchant API.

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

Giai đoạn thử nghiệm này giúp chúng tôi có cơ hộ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 công khai. Để 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 xếp hạng bằng biểu tượng ngón tay cái trên 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.