Trang này được dịch bởi Cloud Translation API.

Method: accounts.productInputs.insert

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
- Biểu diễn dưới dạng JSON
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ố

Tham số
`parent`	`string` 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}

parent

string

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ố

Tham số
`dataSource`	`string` 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: `accounts/{account}/dataSources/{datasource}`.

dataSource

string

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: accounts/{account}/dataSources/{datasource}.

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

Biểu diễn dưới dạng JSON
{ "name": string, "product": string, "channel": enum (`ChannelEnum`), "offerId": string, "contentLanguage": string, "feedLabel": string, "attributes": { object (`Attributes`) }, "customAttributes": [ { object (`CustomAttribute`) } ], "versionNumber": string }

{
  "name": string,
  "product": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}

Trường
`name`	`string` Giá trị nhận dạng. Tên đầu vào của sản phẩm. Định dạng `"{productinput.name=accounts/{account}/productInputs/{productinput}}"`
`product`	`string` Chỉ có đầu ra. Tên của sản phẩm đã xử lý. Định dạng `"{product.name=accounts/{account}/products/{product}}"`
`channel`	`enum (ChannelEnum)` Bắt buộc. Không thể thay đổi. Kênh của sản phẩm.
`offerId`	`string` 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`	`string` 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`	`string` Bắt buộc. Không thể thay đổi. Nhãn nguồn cấp dữ liệu cho sản phẩm.
`attributes`	`object (Attributes)` Không bắt buộc. Danh sách các thuộc tính sản phẩm.
`customAttributes[]`	`object (CustomAttribute)` 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ụ: `{ "name": "size type", "value": "regular" }`). Cách này rất hữu ích khi gửi các thuộc tính không được API nêu rõ, chẳng hạn như các thuộc tính bổ sung dùng cho chương trình Mua trên Google. Số lượng ký tự tối đa cho phép đối với mỗi thuộc tính tuỳ chỉnh là 10240 (đại diện cho tổng số ký tự của tên và giá trị). Bạn có thể đặt tối đa 2500 thuộc tính tuỳ chỉnh cho mỗi sản phẩm, với tổng kích thước là 102,4kB. Sau khi chèn, dấu gạch dưới trong tên thuộc tính tuỳ chỉnh sẽ được thay thế bằng dấu cách.
`versionNumber`	`string (int64 format)` 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 `versionNumber` hiện tại. 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.