Lấy dữ liệu sản phẩm

Trong các dòng công việc sử dụng dữ liệu sản phẩm, bạn có thể dùng thao tác Lấy dữ liệu sản phẩm để lấy thông tin sản phẩm từ cửa hàng.

Lưu ý

Đây là một loại thao tác Lấy dữ liệu. Để hiểu cách sử dụng loại thao tác này với yếu tố kích hoạt Thời gian đã lên lịch và vòng lặp Cho mỗi, hãy tham khảo phần Lịch trình, thao tác lấy dữ liệu và dòng công việc lặp trong Shopify Flow.

Cấu hình

Trường

Thao tác Lấy dữ liệu sản phẩm có chứa các trường sau dùng để xây dựng truy vấn:

Các trường dùng trong thao tác Lấy dữ liệu.

Trường	Mô tả
Sắp xếp dữ liệu theo	Bắt buộc. Các tham số dùng để sắp xếp dữ liệu do truy vấn tìm kiếm trả về.
Số lượng kết quả tối đa	Bắt buộc. Số lượng kết quả tối đa có thể trả về từ truy vấn tìm kiếm bạn chọn. Bạn có thể trả về tối đa 100 kết quả mỗi lần.
Truy vấn	Bắt buộc. Chọn từ các truy vấn phổ biến hoặc chọn Nâng cao để tạo truy vấn riêng.

Chuỗi truy vấn

Đây là ví dụ truy vấn để lấy thông tin sản phẩm đã cập nhật trong ngày qua:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Biến updated_at là bộ lọc có sẵn trên Truy vấn sản phẩm và có thể dùng nhiều lần hoặc kết hợp với các biến khác. Biến Liquid scheduledAt có sẵn trên những dòng công việc sử dụng yếu tố kích hoạt Thời gian đã lên lịch. Thẻ Liquid date_minus là thẻ Flow đặc biệt cho phép bạn trừ bớt thời gian khỏi một ngày.

Khi truy vấn dữ liệu, bạn cần lưu ý:

• Danh sách các bộ lọc sản phẩm có sẵn
• Các truy vấn phải tuân theo một cú pháp nhất định
• Giá trị của trường truy vấn không phải lúc nào cũng có trong tài liệu. Trong một số trường hợp, bạn có thể tìm thấy các giá trị này khi xem tài liệu API. Ngoài ra, bạn thường có thể tìm thấy giá trị trường trong URL ở bảng điều khiển quản trị khi lọc. Ví dụ: để tìm một số giá trị truy vấn Đơn hàng, hãy lọc trang Đơn hàng trong bảng điều khiển quản trị rồi kiểm tra URL.
• Bạn có thể chạy hoặc kiểm tra truy vấn trong cửa hàng bằng cách sử dụng ứng dụng Shopify GraphiQL.
• Hãy lưu ý về những gì sẽ xảy ra nếu truy vấn không thành công. Thông thường, API sẽ trả về tất cả kết quả (thay vì không có kết quả nào).

Dữ liệu trả về

Mọi thao tác Lấy dữ liệu đều trả về một danh sách chứa từ 0 đến 100 tài nguyên. Tùy thuộc vào trường hợp sử dụng, bạn có thể muốn dùng dữ liệu này theo nhiều cách khác nhau:

• Nếu cần xử lý riêng từng mục trong danh sách, chẳng hạn như gắn thẻ cho mỗi mục, bạn có thể sử dụng thao tác Cho mỗi.
• Nếu cần tổng hợp dữ liệu, chẳng hạn như đếm số kết quả trả về, bạn có thể sử dụng thao tác Đếm hoặc Tính tổng.
• Nếu cần xuất danh sách, chẳng hạn như gửi email chứa tất cả các mục, bạn có thể dùng trực tiếp dữ liệu trả về ở những thao tác tiếp theo.

Để truy cập dữ liệu trả về trong các bước theo sau thao tác này, hãy sử dụng biến Lấy dữ liệu sản phẩm (đây là danh sách sản phẩm). Bạn có thể dùng biến này trong cả điều kiện và thao tác. Ví dụ: bạn có thể gửi danh sách sản phẩm trong thao tác Gửi email nội bộ như sau:

{% for single_product in GetProductData %}
* {{ single_product.name }}
{% endfor %}

Lưu ý

Nếu một thao tác Lấy dữ liệu được sử dụng nhiều lần trong cùng một dòng công việc, thì sẽ có một số được thêm vào tên biến. Ví dụ: trong dòng công việc dùng thao tác Lấy dữ liệu đơn hàng hai lần, biến đầu tiên cho dữ liệu trả về sẽ là getOrderData và biến thứ hai là getOrderData1. Không thể tùy chỉnh tên này.

Yếu tố kích hoạt

Bạn có thể sử dụng thao tác này trong mọi dòng công việc, bao gồm cả yếu tố kích hoạt Thời gian đã lên lịch. Trong dòng công việc sử dụng yếu tố kích hoạt Thời gian đã lên lịch, dòng công việc sẽ bắt đầu vào thời gian bạn chỉ định thay vì kết quả của một sự kiện. Do không có sự kiện cụ thể nào trong cửa hàng hoặc từ ứng dụng để bắt đầu dòng công việc nên sẽ không có dữ liệu nào tự động đưa vào.

Chi tiết API

• Tài nguyên sản phẩm
• Bộ lọc truy vấn sản phẩm

Mẫu

Thêm sản phẩm có thẻ vào bộ sưu tập trong tương lai

Tại một thời điểm trong tương lai, lấy tất cả sản phẩm có thẻ nhất định, sau đó thêm vào một bộ sưu tập. Xem mẫu

Xóa sản phẩm không hoạt động

Xóa các sản phẩm hết hàng tồn kho chưa được cập nhật trong vòng một năm. Xem mẫu

Đăng các sản phẩm có thẻ nhất định trong tương lai

Vào một ngày trong tương lai, lấy các sản phẩm có thẻ nhất định và đăng. Sử dụng yếu tố kích hoạt Thời gian đã lên lịch và thao tác Lấy dữ liệu sản phẩm. Xem mẫu

Xóa thẻ sản phẩm mới sau 90 ngày kể từ khi tạo sản phẩm

Lấy tối đa 100 sản phẩm mỗi ngày đã tạo cách đây hơn 90 ngày mà vẫn giữ thẻ "new". Sau đó, dòng công việc sẽ xóa những thẻ này cho từng sản phẩm. Xem mẫu

Lên lịch xóa sản phẩm khỏi Cửa hàng trực tuyến vào ngày và giờ chỉ định

Xóa sản phẩm khỏi cửa hàng trực tuyến theo thẻ, ID hoặc mã SKU vào một ngày cụ thể trong tương lai. Có sử dụng yếu tố kích hoạt Thời gian đã lên lịch, thao tác Lấy dữ liệu sản phẩm và vòng lặp Cho mỗi. Xem mẫu

Gửi tóm tắt qua email hằng ngày kèm theo sản phẩm hết hàng

Lấy tất cả sản phẩm có mức hàng tồn kho bằng 0 mỗi ngày, rồi gửi tóm tắt qua email. Sử dụng thao tác Lấy dữ liệu sản phẩm và yếu tố kích hoạt Thời gian đã lên lịch. Xem mẫu

Gửi thông báo qua email khi biến thể được thêm bị trùng lặp mã SKU

Khi có một biến thể mới được thêm, hệ thống sẽ kiểm tra xem có biến thể nào khác sử dụng cùng mã SKU hay không. Nếu có, hệ thống sẽ gửi email nội bộ chứa liên kết đến các sản phẩm và biến thể bị ảnh hưởng. Xem mẫu

Theo dõi các biến thể sản phẩm đang giảm giá bằng trường siêu dữ liệu sản phẩm

Đặt một trường siêu dữ liệu cho sản phẩm nếu có ít nhất một trong các biến thể của sản phẩm đó đang giảm giá. Thao tác này có thể hữu ích cho việc theo dõi các sản phẩm đang được giảm giá hiện tại. Xem mẫu