getProductsByIds

Lấy nhiều sản phẩm theo các id của chúng.

Sản phẩm?.getProductsByIds( ids?, langCode?, userQuery? );

const value = await Products.getProductsByIds('1, 5, 8', 'en_US')

Ví dụ tối thiểu

Schema

ids: string
Các định danh trang sản phẩm để tìm mối quan hệ
ví dụ: "12345,67890"

langCode: string
Mã ngôn ngữ. Mặc định "en_US"

userQuery: IProductsQuery
Tham số truy vấn tùy chọn
ví dụ:

{
  "offset": 0,
  "limit": 30,
  "sortOrder": "DESC",
  "sortKey": "id"
}

offset(bắt buộc): number
Tham số cho phân trang. Mặc định: 0.

limit(bắt buộc): number
Tham số cho phân trang. Mặc định: 30.

sortOrder(bắt buộc): string
Thứ tự sắp xếp "DESC" | "ASC". Mặc định: "DESC".

sortKey(bắt buộc): string
Trường để sắp xếp (mặc định - null). Các giá trị có thể: "id", "position", "title", "date", "price". Mặc định: null.

templateMarker: string | null
Đánh dấu mẫu trang sản phẩm, mặc định null.
ví dụ: "template_12345"

statusMarker: string | null
Đánh dấu trạng thái trang sản phẩm, mặc định null.
ví dụ: "in_stock"

conditionValue: string | null
Giá trị đang được tìm kiếm, mặc định null.
ví dụ: "new"

attributeMarker: string | null
Định danh văn bản của thuộc tính đã được lập chỉ mục mà qua đó các giá trị được lọc, mặc định null.
ví dụ: "color"

conditionMarker: string | null
Đánh dấu điều kiện lọc mà qua đó các giá trị được lọc, mặc định null.
ví dụ: "equals"

Phương thức này lấy các đối tượng sản phẩm dựa trên các định danh (ids) của chúng từ API. Nó trả về một Promise mà khi hoàn thành sẽ trả về các đối tượng IProductsEntity cho sản phẩm.

Ví dụ phản hồi

[
  {
    "id": 2954,
    "localizeInfos": {
      "title": "Hộp"
    },
    "statusIdentifier": "sale",
    "statusLocalizeInfos": {
      "title": "Giảm giá"
    },
    "attributeSetIdentifier": "products",
    "position": 2,
    "templateIdentifier": null,
    "shortDescTemplateIdentifier": "product_preview",
    "price": 50,
    "additional": {
      "prices": {
        "min": 50,
        "max": 150
      }
    },
    "sku": null,
    "isSync": true,
    "attributeValues": {
      "product-name": {
        "type": "string",
        "value": "tên-sản-phẩm",
        "isIcon": false,
        "position": 0,
        "additionalFields": [],
        "isProductPreview": false
      },
      "price": {
        "type": "integer",
        "value": 50,
        "isIcon": false,
        "position": 1,
        "additionalFields": [],
        "isProductPreview": false
      },
      "currency_products": {
        "type": "string",
        "value": "usd",
        "isIcon": false,
        "position": 2,
        "additionalFields": [],
        "isProductPreview": false
      },
      "img": {
        "type": "image",
        "value": [],
        "isIcon": false,
        "position": 3,
        "additionalFields": [],
        "isProductPreview": false
      }
    },
    "categories": [
      "catalog"
    ],
    "isVisible": true,
    "productPages": [
      {
        "id": 2847,
        "pageId": 10,
        "productId": 2954,
        "positionId": 3190,
        "categoryPath": "catalog"
      }
    ],
    "blocks": [
      "product_block",
      "product_block"
    ]
  },
  {
    "id": 2955,
    "localizeInfos": {
      "title": "Sản phẩm"
    },
    "statusIdentifier": "sale",
    "statusLocalizeInfos": {
      "title": "Giảm giá"
    },
    "attributeSetIdentifier": null,
    "position": 1,
    "templateIdentifier": null,
    "shortDescTemplateIdentifier": null,
    "price": null,
    "additional": {
      "prices": {
        "min": 50,
        "max": 150
      }
    },
    "sku": null,
    "isSync": false,
    "attributeValues": {},
    "categories": [
      "catalog"
    ],
    "isVisible": true,
    "productPages": [
      {
        "id": 2848,
        "pageId": 10,
        "productId": 2955,
        "positionId": 3191,
        "categoryPath": "catalog"
      }
    ],
    "blocks": [
      "product_block",
      "product_block"
    ]
  }
]

Schema

id: number
Định danh duy nhất.
ví dụ: 12345

localizeInfos: ILocalizeInfo
Tên của các sản phẩm, tính đến việc địa phương hóa.

statusIdentifier: string | null
Định danh trạng thái trang sản phẩm (có thể là null).
ví dụ: "in_stock"

statusLocalizeInfos: any
Mô tả JSON của đối tượng trạng thái, tính đến ngôn ngữ.

attributeSetIdentifier: string | null
Tập hợp các id thuộc tính.
ví dụ: "set_12345"

position: number
Số thứ tự của mục (để sắp xếp).
ví dụ: 1

templateIdentifier: string | null
Id người dùng của mẫu liên kết.
ví dụ: "template_12345"

shortDescTemplateIdentifier: string | null
Id người dùng của mẫu liên kết cho mô tả ngắn.
ví dụ: "short_desc_template_12345"

price: number
Giá trị của giá trang sản phẩm lấy từ chỉ mục.
ví dụ: 150

additional: object
Giá trị bổ sung từ chỉ mục.

sku: string | null
SKU sản phẩm (Đơn vị giữ hàng), có thể là null.
ví dụ: "SKU_12345"

isSync: boolean
Chỉ báo về việc lập chỉ mục trang.
ví dụ: true

attributeValues: AttributeType
Mảng các giá trị thuộc tính từ chỉ mục, được biểu diễn.
ví dụ:

[
  {
    "id": "color",
    "value": "red"
  }
]

categories: string[]
Các danh mục sản phẩm.
ví dụ:

[
  1,
  2,
  3
]

isVisible: boolean
Dấu hiệu về tính khả thi của trang.
ví dụ: true

productPages: any[]
Mảng các trang sản phẩm hoặc một đối tượng trang sản phẩm đơn lẻ.

blocks: string[]
Mảng các định danh khối.

isPositionLocked: boolean
Chỉ báo khóa vị trí sắp xếp (tùy chọn).
ví dụ: false

relatedIds: number[]
Cac id của các trang sản phẩm liên quan.
ví dụ:

[
  12345, 
  67890
]

---