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 bằng cách 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 một nguồn dữ liệu, truy xuất sản phẩm từ tài khoản của bạn và xoá sản phẩm khỏi một nguồn dữ liệu.
Merchant Products API chứa hai tài nguyên.
productInputsđại diện cho các phần đầu vào của sản phẩm.productsđại diện cho các sản phẩm đã xử lý được tạo từ các phần đầu vào.
productInputs có thể là chính và bổ sung, tuỳ thuộc vào việc bạn tải tệp này lên nguồn dữ liệu chính hay nguồn dữ liệu bổ sung.
Mỗi product sẽ được tạo từ một productInput chính và bất kỳ số lượng productInputs bổ sung nào.
Bạn có thể sử dụng Merchant Products API để tạo danh mục cửa hàng trực tuyến hoặc tại cửa hàng địa phương. Đây là những sản phẩm có thể xuất hiện trên nhiều vị trí mua sắm.
Bạn có thể sử dụng tài nguyên productInputs sau khi tạo tài khoản Merchant Center, thiết lập nguồn dữ liệu đầu tiên và sẵn sàng tải một nhóm sản phẩm ban đầu lên thông qua API.
Mặc dù người bán có thể tải sản phẩm lên bằng tệp có tên là PrimaryProductDataSource, nhưng việc tạo và xoá sản phẩm bằng Merchant API có một số ưu điểm. Những lợi thế này bao gồm thời gian phản hồi nhanh hơn và khả năng cập nhật sản phẩm theo thời gian thực mà không cần quản lý các tệp lớn. Có thể mất đến vài giờ để các thay đổi đối với sản phẩm do lệnh gọi API thực hiện xuất hiện trong cơ sở dữ liệu Mua sắm.
Đ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 Merchant DataSources API hoặc Merchant Center.
Nếu đã tạo một nguồn dữ liệu bằng giao diện người dùng Merchant Center hoặc bằng 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 để tìm hiểu cách bắt đầu sử dụng Merchant Products API.
Bạn có trách nhiệm tuân thủ các chính sách về 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 thích đáng nếu phát hiện nội dung hoặc hành vi vi phạm các chính sách này.
Tài nguyên
Tài nguyên products cho phép bạn truy xuất thông tin sản phẩm từ cơ sở dữ liệu Mua sắm.
Tài nguyên productInput đại diện cho dữ liệu đầu vào mà bạn gửi cho một sản phẩm. Lớp này cũng cung cấp các phương thức cho phép bạn cập nhật hoặc xoá từng thông tin sản phẩm hoặc nhiều thông tin sản phẩm cùng một lúc ở chế độ hàng loạt. Tài nguyên productInput phải có các trường sau:
channel: Kênh của sản phẩm.offerId: Giá trị nhận dạng duy nhất của sản phẩm.contentLanguage: Mã ngôn ngữ ISO 639-1 gồm hai chữ cái cho sản phẩm.feedLabel: Nhãn nguồn cấp dữ liệu cho sản phẩm.
Tải dữ liệu đầu vào về sản phẩm lên tài khoả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.
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 thì sản phẩm đã xử lý mới xuất hiện sau khi chèn.
Bạn có thể lấy tên tài nguyên của sản phẩm đã xử lý từ trường product trong phản hồi của accounts.productInputs.insert
Xoá thông tin sản phẩm khỏi tài khoản
Để xoá dữ liệu đầu vào về sản phẩm khỏi tài khoả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 bổ sung mà sản phẩm thuộc về để xoá sản phẩm bằng Merchant Products API.
Liệt kê sản phẩm trong tài khoản
Để liệt kê các sản phẩm đã xử lý trong tài khoản, hãy sử dụng phương thức accounts.products.list.