Trợ giúp
Đăng nhập

Lấy dữ liệu thị trường

Trong các dòng công việc cần dữ liệu thị trường, bạn có thể sử dụng thao tác Lấy dữ liệu thị trường để truy xuất thông tin thị trường từ cửa hàng Shopify. Thị trường là các nhóm khu vực hoặc địa điểm bạn nhắm tới để bán hàng.

Trên trang này

Cấu hình

Trường

Thao tác Lấy dữ liệu thị trường chứa các trường sau:

Các trường dùng trong thao tác Lấy dữ liệu.
TrườngMô tả
Sắp xếp dữ liệu theoBắt buộc. Các tham số để 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 đaBắt buộc. Số lượng kết quả tối đa có thể trả về thông qua truy vấn tìm kiếm bạn đã chọn. Có thể trả về tối đa 100 kết quả mỗi lần.
Truy vấnBắ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à truy vấn ví dụ để lấy tất cả thị trường đang hoạt động:

status:ACTIVE

Biến status là một bộ lọc trong Truy vấn thị trườ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.

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

  • Danh sách các bộ lọc thị trường hiện có

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

  • Giá trị 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, có thể tìm giá trị 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 Orders trong bảng điều khiển quản trị, sau đó kiểm tra URL.

  • Có thể chạy hoặc kiểm tra truy vấn trong cửa hàng bằng ứng dụng Shopify GraphiQL.

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

Dữ liệu trả về

Mọi thao tác Lấy dữ liệu trả về danh sách có 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ể 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, ví dụ như để gắn thẻ cho mỗi mục, bạn có thể sử dụng thao tác Đối với 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, ví dụ 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ề ở các bước sau thao tác này, hãy dùng biến Lấy dữ liệu thị trường (là danh sách các thị trường). Bạn có thể sử dụng biến này ở cả điều kiện và thao tác. Ví dụ: bạn có thể gửi danh sách thị trường trong thao tác Gửi email nội bộ tương tự như sau:

{% for single_market in GetMarketData %}
    * {{ single_market.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 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ì 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ừ một ứng dụng khởi chạy dòng công việc, sẽ không có dữ liệu nào tự động được đưa vào.

Tài liệu tham khảo API

Để biết thêm thông tin về API dùng trong thao tác này, hãy xem Truy vấn thị trường.