Định nghĩa Metafield
Metafield cho phép bạn lưu trữ dữ liệu tùy chỉnh cho sản phẩm, đơn hàng, khách hàng và các tài nguyên khác trong Shopify. Chúng hữu ích để thêm thông tin bổ sung như hướng dẫn kích thước, thông số kỹ thuật, dữ liệu SEO hoặc ghi chú nội bộ.
Tìm hiểu thêm về metafield trong Shopify →
Với DataEase, bạn có thể nhập, xuất và cập nhật metafield dễ dàng bằng cách sử dụng cột động trong tệp của mình.
📊 Cách Metafield Hoạt Động Trong DataEase
Section titled “📊 Cách Metafield Hoạt Động Trong DataEase”Khi bạn xuất dữ liệu từ DataEase, metafield được hiển thị dưới dạng cột động. Điều này có nghĩa là mỗi metafield có một cột riêng trong tệp, sử dụng định dạng đặt tên cụ thể:
metafield {namespace}.{name} [{type}]
Ví dụ:
Section titled “Ví dụ:”metafield global.description_tag [single_line_text_field]
Cấu trúc này cho DataEase (và Shopify) biết bạn đang đề cập đến metafield nào và ở định dạng nào.
🧠 Logic Nhập Metafield
Section titled “🧠 Logic Nhập Metafield”- Nếu một metafield không có trong tệp nhập của bạn, nó sẽ không bị thay đổi.
- Nếu một metafield có trong tệp nhưng trống, nó sẽ bị xóa khỏi Shopify.
- Nếu một metafield có giá trị, nó sẽ được tạo hoặc cập nhật.
Điều này giúp dễ dàng quản lý metafield mà không ghi đè dữ liệu bạn không muốn thay đổi.
🧩 Các Loại Metafield Được Hỗ Trợ
Section titled “🧩 Các Loại Metafield Được Hỗ Trợ”Shopify hỗ trợ nhiều loại metafield khác nhau. Bạn có thể xem danh sách đầy đủ tại đây:
Sử dụng các loại này trong tiêu đề cột khi nhập. Ví dụ:
metafield specs.material [multi_line_text_field]
metafield shipping.weight [number_decimal]
📏 Giới Hạn Metafield
Section titled “📏 Giới Hạn Metafield”Trước khi làm việc với metafield, hãy lưu ý đến các giới hạn của Shopify:
🔢 Giới hạn theo tài nguyên
Section titled “🔢 Giới hạn theo tài nguyên”- 250 định nghĩa cho mỗi loại tài nguyên
- 20 định nghĩa ghim cho mỗi loại tài nguyên
📦 Giới hạn ký tự theo loại
Section titled “📦 Giới hạn ký tự theo loại”| Loại | Giới Hạn Ký Tự |
|---|---|
| boolean | 65,000 |
| color | 65,000 |
| date | 65,000 |
| date_time | 65,000 |
| dimension | 65,000 |
| id | 2,048 |
| json | 2,000,000 |
| link | 65,000 |
| money | 65,000 |
| multi_line_text_field | 65,000 |
| number_decimal | 65,000 |
| number_integer | 65,000 |
| rating | 65,000 |
| rich_text_field | 65,000 |
| single_line_text_field | 65,000 |
| url | 2,048 |
| volume | 65,000 |
| weight | 65,000 |
Xem đầy đủ giới hạn metafield →
🔐 Loại chủ sở hữu và quyền truy cập (Admin API 2026-07)
Section titled “🔐 Loại chủ sở hữu và quyền truy cập (Admin API 2026-07)”- Chuyển kho (
TRANSFER) — định nghĩa metafield của chuyển kho có thể được xuất, nhập và sao chép giữa các cửa hàng. Việc nhập chúng cần quyền chuyển kho (read_inventory_transfers,write_inventory_transfers), mà ứng dụng yêu cầu kể từ ngày 27/9/2026. Cho đến khi chủ cửa hàng mở DataEase và chấp thuận quyền cập nhật, các dòngTRANSFERsẽ thất bại với lỗi yêu cầu chấp thuận; tất cả các dòng khác vẫn được nhập bình thường. - Quyền truy cập quản trị (
accessAdmin) trong namespace của riêng bạn (ví dụcustom) — Shopify chỉ cho phép một giá trị ở đó, vì vậy DataEase không gửiaccessAdmincho các định nghĩa như vậy và Shopify tự áp dụng nó. Giá trịPUBLIC_READ/PUBLIC_READ_WRITEtrong tệp không còn gây ra lỗi Shopify nữa. - Quyền truy cập quản trị trong namespace của ứng dụng (
$app,app--…) —MERCHANT_READvàMERCHANT_READ_WRITEđược gửi nguyên trạng; các giá trị cũPUBLIC_READ/PUBLIC_READ_WRITEtừ các tệp cũ hơn được gửi dưới dạngMERCHANT_READ/MERCHANT_READ_WRITE.
🧰 Ví Dụ Sử Dụng
Section titled “🧰 Ví Dụ Sử Dụng”Thêm thẻ SEO tùy chỉnh cho sản phẩm:
- Xuất sản phẩm với DataEase
- Thêm một cột mới: metafield global.title_tag [single_line_text_field]
- Nhập tiêu đề SEO của bạn vào cột
- Nhập tệp đã cập nhật - metafield của bạn đã hoạt động!
✅ Thực Hành Tốt Nhất
Section titled “✅ Thực Hành Tốt Nhất”- Sử dụng định dạng chính xác trong dấu ngoặc vuông cho mỗi metafield.
- Tránh ghi đè dữ liệu quan trọng - loại bỏ các cột cho các trường bạn không muốn thay đổi.
- Sử dụng xuất để sao lưu metafield hiện tại của bạn trước khi thực hiện thay đổi.
Metafield là một cách mạnh mẽ để mở rộng chức năng của cửa hàng Shopify của bạn. Với DataEase, bạn có thể quản lý chúng hiệu quả - theo lô - và không cần phải viết mã.
Các trường bổ sung
Section titled “Các trường bổ sung”Nhiều cột hơn mà DataEase hỗ trợ cho thực thể này:
accessAdmin— Mức truy cập quản trị cho định nghĩa metafield. Chỉ áp dụng cho namespace của ứng dụng (xem Loại chủ sở hữu và quyền truy cập ở trên).accessCustomer— Mức truy cập khách hàng cho định nghĩa metafield.accessStoreFront— Mức truy cập cửa hàng cho định nghĩa metafield.capabilitiesAdminFilterableEnabled— Chỉ định nếu lọc quản trị được bật cho metafield.capabilitiesAdminFilterableEligible— Trạng thái đủ điều kiện cho khả năng lọc quản trị.capabilitiesAdminFilterableStatus— Trạng thái hiện tại của khả năng lọc quản trị.capabilitiesSmartCollectionConditionEnabled— Chỉ định nếu điều kiện bộ sưu tập thông minh được bật cho metafield.capabilitiesSmartCollectionConditionEligible— Trạng thái đủ điều kiện cho khả năng điều kiện bộ sưu tập thông minh.capabilitiesUniqueValuesEnabled— Chỉ định nếu giá trị duy nhất được bật cho metafield.capabilitiesUniqueValuesEligible— Trạng thái đủ điều kiện cho khả năng giá trị duy nhất.constraintsKey— Các ràng buộc áp dụng cho khóa metafield.constraintsValues— Các ràng buộc áp dụng cho giá trị metafield.metafieldsCount— Số lượng metafield liên kết với định nghĩa.pinnedPosition— Chỉ định nếu metafield được ghim trong quản trị.metafieldsValidationStatus— Trạng thái xác thực của metafield.category— Danh mục của định nghĩa metafield.description— Mô tả của định nghĩa metafield.key— Khóa cho định nghĩa metafield.name— Tên của định nghĩa metafield.namespace— Namespace cho định nghĩa metafield.ownerType— Loại chủ sở hữu liên kết với định nghĩa metafield (ví dụPRODUCT,CUSTOMER,TRANSFER).type— Loại dữ liệu của định nghĩa metafield.validations— Mảng JSON của các xác thực cho định nghĩa metafield.deleteAssociatedMetafields— Chỉ định nếu metafield liên kết nên bị xóa.