- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
Tải dữ liệu đầu vào về sản phẩm lên tài khoản Merchant Center. Nếu đã có một mục nhập có cùng contentLanguage, offerId và dataSource, thì phương thức này sẽ thay thế mục nhập đó.
Sau khi chèn, cập nhật hoặc xoá thông tin đầu vào của sản phẩm, hệ thống có thể mất vài phút để truy xuất được sản phẩm đã xử lý.
Yêu cầu HTTP
POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
parent |
Bắt buộc. Tài khoản mà bạn sẽ chèn sản phẩm này. Định dạng: accounts/{account} |
Tham số truy vấn
Tham số | |
---|---|
dataSource |
Bắt buộc. Tên nguồn dữ liệu sản phẩm chính hoặc bổ sung. Nếu sản phẩm đã tồn tại và nguồn dữ liệu được cung cấp khác, thì sản phẩm này sẽ được chuyển sang một nguồn dữ liệu mới. Định dạng: |
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của ProductInput
.
Nội dung phản hồi
Tài nguyên này đại diện cho dữ liệu đầu vào mà bạn gửi cho một sản phẩm, chứ không phải sản phẩm đã xử lý mà bạn thấy trong Merchant Center, trong quảng cáo Mua sắm hoặc trên các nền tảng của Google. Dữ liệu đầu vào, quy tắc và nguồn dữ liệu bổ sung về sản phẩm được kết hợp để tạo ra [sản phẩm][google.shopping.content.bundles.Products.Product] đã xử lý.
Các thuộc tính bắt buộc đầu vào sản phẩm để vượt qua các bước kiểm tra xác thực dữ liệu chủ yếu được xác định trong quy cách dữ liệu sản phẩm.
Các thuộc tính sau đây là bắt buộc: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] và [offerId][google.shopping.content.bundles.Products.offer_id].
Sau khi chèn, cập nhật hoặc xoá thông tin đầu vào của sản phẩm, hệ thống có thể mất vài phút để truy xuất được sản phẩm đã xử lý.
Tất cả các trường trong dữ liệu đầu vào của sản phẩm và thông báo phụ của sản phẩm đều khớp với tên tiếng Anh của thuộc tính tương ứng trong thông số ngành dọc với một số trường hợp ngoại lệ.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "product": string, "channel": enum ( |
Trường | |
---|---|
name |
Giá trị nhận dạng. Tên đầu vào của sản phẩm. Định dạng |
product |
Chỉ có đầu ra. Tên của sản phẩm đã xử lý. Định dạng |
channel |
Bắt buộc. Không thể thay đổi. Kênh của sản phẩm. |
offerId |
Bắt buộc. Không thể thay đổi. Giá trị nhận dạng duy nhất của sản phẩm. Điều này tương tự với sản phẩm đầu vào và sản phẩm đã xử lý. Khoảng trắng ở đầu và ở cuối bị xoá đi và nhiều khoảng trắng được thay bằng một khoảng trắng duy nhất khi gửi. Xem quy cách dữ liệu sản phẩm để biết chi tiết. |
contentLanguage |
Bắt buộc. Không thể thay đổi. Mã ngôn ngữ gồm hai chữ cái theo tiêu chuẩn ISO 639-1 cho sản phẩm. |
feedLabel |
Bắt buộc. Không thể thay đổi. Nhãn nguồn cấp dữ liệu cho sản phẩm. |
attributes |
Không bắt buộc. Danh sách các thuộc tính sản phẩm. |
customAttributes[] |
Không bắt buộc. Danh sách các thuộc tính tuỳ chỉnh (do người bán cung cấp). Bạn cũng có thể sử dụng thuộc tính này để gửi bất kỳ thuộc tính nào của quy cách dữ liệu ở dạng chung chung (ví dụ: |
versionNumber |
Không bắt buộc. Đại diện cho phiên bản hiện có (độ mới) của sản phẩm, có thể được dùng để duy trì thứ tự phù hợp khi nhiều nội dung cập nhật được thực hiện cùng một lúc. Nếu bạn đặt số này, việc chèn sẽ không được thực hiện khi số phiên bản thấp hơn số phiên bản hiện tại của sản phẩm hiện có. Bạn có thể chèn lại (ví dụ: làm mới sản phẩm sau 30 ngày) bằng Chỉ hỗ trợ để chèn vào nguồn dữ liệu chính. Nếu thao tác này bị ngăn chặn, thì ngoại lệ bị huỷ sẽ được gửi. |
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/content
Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.