Lấy dữ liệu thẻ quà tặng

Trong các dòng công việc yêu cầu dữ liệu thẻ quà tặng, bạn có thể sử dụng thao tác Lấy dữ liệu thẻ quà tặng để truy xuất thông tin thẻ quà tặng từ cửa hàng.

Điều quan trọng là cửa hàng của bạn có cả sản phẩm thẻ quà tặng (dùng để tạo thẻ quà tặng) và bản thân thẻ quà tặng (thẻ quà tặng thực tế mà khách hàng có thể dùng để mua hàng). Thao tác Lấy dữ liệu thẻ quà tặng sẽ truy xuất thông tin về chính các thẻ quà tặng. Để lấy thông tin về sản phẩm thẻ quà tặng, hãy sử dụng thao tác Lấy dữ liệu sản phẩm hoặc Lấy dữ liệu biến thể sản phẩm.

Cấu hình

Trường

Thao tác Lấy dữ liệu thẻ quà tặng chứa các trường sau đây, dùng để xây dựng truy vấn:

Chuỗi truy vấn

Sau đây là ví dụ về truy vấn để lấy các thẻ quà tặng đã cập nhật trong ngày hôm qua:

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

Biến created_at là bộ lọc có sẵn trên truy vấn thẻ quà tặng và có thể sử 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 các 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à một thẻ Flow đặc biệt cho phép bạn trừ đi thời gian từ một ngày.

Khi truy vấn dữ liệu, bạn nên biết những thông tin sau:

• Danh sách các bộ lọc thẻ quà tặng có sẵn

• Các truy vấn phải tuân theo cú pháp nhất định

• Không phải lúc nào giá trị trường truy vấn cũng được ghi chép vào 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 bằng cách 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 của mình bằng cách sử dụng ứng dụng Shopify GraphiQL.

• Hãy lưu ý điều gì sẽ xảy ra nếu truy vấn bị lỗi. API thường sẽ trả về tất cả kết quả (thay vì không có gì).

Dữ liệu trả về

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

• 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 từng 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ố lượng 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ể sử dụng trực tiếp dữ liệu trả về trong các thao tác tiếp theo.

Để truy cập dữ liệu trả về trong các bước tiếp theo sau thao tác này, hãy sử dụng biến có tên Lấy dữ liệu thẻ quà tặng (danh sách thẻ quà tặng). Bạn có thể sử 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 thẻ quà tặng trong thao tác Gửi email nội bộ như sau:

{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}

Yếu tố kích hoạt

Bạn có thể sử dụng thao tác này trong bất kỳ dòng công việc nào, 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 bắt đầu vào thời gian bạn đã chỉ định, thay vì do 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 không có dữ liệu nào được tự động đưa vào.

Chi tiết API

• Tài nguyên thẻ quà tặng
• Bộ lọc truy vấn thẻ quà tặng