Trang này giải thích cách bạn có thể tải sản phẩm lên và quản lý sản phẩm theo phương thức lập trình. Khi sử dụng Merchant Products API, bạn có thể chèn hoặc cập nhật sản phẩm trong nguồn dữ liệu, truy xuất sản phẩm từ tài khoản của mình và xoá sản phẩm khỏi nguồn dữ liệu.
Bạn có thể sử dụng tài nguyên products để tạo danh mục cửa hàng trực tuyến. Đây là danh sách các sản phẩm có trên quảng cáo Mua sắm. Bạn có thể sử dụng tài nguyên products
sau khi tạo tài khoản Merchant Center và sẵn sàng tải
nhóm sản phẩm ban đầu lên thông qua API.
Bạn có trách nhiệm tuân thủ các chính sách của quảng cáo Mua sắm và trang thông tin miễn phí. Quảng cáo Mua sắm có quyền thực thi các chính sách này và phản hồi một cách thích hợp nếu chúng tôi phát hiện thấy nội dung hoặc hành vi vi phạm các chính sách này.
Tài nguyên products tải thông tin sản phẩm lên cơ sở dữ liệu của Shopping Merchant Center. API này cũng cung cấp một số phương thức cho phép bạn truy cập, cập nhật hoặc xoá thông tin sản phẩm lần lượt hoặc nhiều phương thức cùng lúc ở chế độ xử lý hàng loạt.
Tài nguyên productInput biểu thị dữ liệu đầu vào mà bạn gửi cho một sản phẩm. Tài nguyên productInput phải có các trường sau:
channel: Kênh của sản phẩm.offerId: Mã nhận dạng duy nhất của sản phẩm. Giá trị này là giống nhau cho dữ liệu đầu vào và sản phẩm đã xử lý.contentLanguage: Mã ngôn ngữ gồm 2 chữ cái theo tiêu chuẩn ISO 639-1 của sản phẩm.feedLabel: Nhãn nguồn cấp dữ liệu cho sản phẩm.
Mặc dù người bán có thể tải sản phẩm bằng một tệp gọi là Nguồn cấp dữ liệu chính, nhưng việc tạo và xoá sản phẩm bằng API Merchant Center vẫn có một số ưu điểm. Những ưu điểm này bao gồm thời gian phản hồi nhanh hơn và khả năng cập nhật nhiều sản phẩm theo thời gian thực mà không cần phải quản lý nhiều nguồn cấp dữ liệu bổ sung. Có thể mất đến vài giờ để các thay đổi về sản phẩm do lệnh gọi API thực hiện mới xuất hiện trong cơ sở dữ liệu của Shopping Merchant Center.
Google có thể giúp bạn tự động duy trì một số thuộc tính của sản phẩm. Để biết thêm thông tin, hãy xem phần Bật tính năng cải thiện tự động.
Điều kiện tiên quyết
Nếu bạn chưa có nguồn dữ liệu, hãy tạo nguồn dữ liệu bằng cách sử dụng Merchant Data Source API hoặc Merchant Center.
Nếu đã có nguồn dữ liệu mà bạn đã tạo bằng giao diện người dùng Merchant Center hoặc API, thì bạn có thể sử dụng Merchant Products API để thêm sản phẩm. Nếu bạn đang sử dụng Content API for Shopping để thêm sản phẩm, hãy tham khảo hướng dẫn di chuyển để hiểu cách bắt đầu sử dụng Merchant Products API.
Tải dữ liệu đầu vào sản phẩm lên tài khoản của bạn
Để tải dữ liệu đầu vào về sản phẩm lên tài khoản, hãy sử dụng phương thức accounts.productInputs.insert. Bạn phải truyền giá trị nhận dạng duy nhất của nguồn dữ liệu chính hoặc nguồn dữ liệu bổ sung để chèn sản phẩm bằng Merchant Products API.
Truy xuất sản phẩm đã xử lý từ tài khoản của bạn
Để truy xuất một sản phẩm đã xử lý từ tài khoản của bạn, hãy sử dụng phương thức accounts.products.get. Có thể mất vài phút để sản phẩm đã xử lý xuất hiện sau khi chèn.
Xoá dữ liệu nhập vào sản phẩm khỏi tài khoản của bạn
Để xoá dữ liệu đầu vào về sản phẩm khỏi tài khoản của bạn, hãy sử dụng phương thức accounts.productInputs.delete. Bạn phải truyền giá trị nhận dạng duy nhất của nguồn dữ liệu chính hoặc nguồn dữ liệu bổ sung chứa sản phẩm đó để xoá sản phẩm bằng cách sử dụng Merchant Products API.
Liệt kê sản phẩm trong tài khoản của bạn
Để liệt kê các sản phẩm đã xử lý trong tài khoản của bạn, hãy sử dụng phương thức accounts.products.list.