Lấy dữ liệu địa điểm

Trong các dòng công việc cần dữ liệu địa điểm, bạn có thể sử dụng thao tác Lấy dữ liệu địa điểm để truy xuất thông tin địa điểm từ cửa hàng Shopify. Địa điểm là bất kỳ nơi nào bạn lưu trữ hàng tồn kho, bán sản phẩm hoặc gửi hàng hay thực hiện đơn 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, lấy dữ liệu và dòng công việc lặp lại trong Shopify Flow.

Cấu hình

Trường

Thao tác Lấy dữ liệu địa điểm chứa các trường sau đây.

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 thông 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 đa	Bắt buộc. Số lượng kết quả tối đa mà truy vấn tìm kiếm bạn chọn có thể trả về. Bạn có thể nhận tới 100 kết quả một lần.
Truy vấn	Bắt buộc. Chọn các truy vấn phổ biến hoặc chọn Nâng cao để tự tạo truy vấn của riêng bạn.

Chuỗi truy vấn

Đây là một truy vấn ví dụ để lấy các địa điểm đã bật tính năng nhận hàng tại cửa hàng:

pickup_in_store:enabled

Biến pickup_in_store là bộ lọc có sẵn trong Truy vấn địa điểm 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, bạn nên biết:

• Danh sách các bộ lọc địa điểm hiện có

• Cá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 ghi chép lại. Trong một số trường hợp, bạn có thể tìm thấy giá trị bằng cách xem tài liệu về API. Ngoài ra, bạn thường có thể tìm thấy các giá trị trường trong các URL của trang quản trị khi lọc. Ví dụ: để tìm một số giá trị truy vấn của Đơn hàng, hãy lọc trang Đơn hàng trong trang 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 dùng ứng dụng Shopify GraphiQL.

• Hãy lưu ý những gì sẽ xảy ra nếu truy vấn của bạn thất bại. 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 sử 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ư để thêm 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ố lượng kết quả được 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 với tất cả các mục, bạn có thể sử dụng trực tiếp dữ liệu trả về ở các 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 sử dụng biến có tên Lấy dữ liệu địa điểm. Biến này là một danh sách các địa điể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 địa điểm trong thao tác Gửi email nội bộ như sau:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Lưu ý

Nếu thao tác Lấy dữ liệu được sử dụng nhiều lần trong một dòng công việc, thì một số sẽ được thêm vào tên biến. Ví dụ: trong dòng công việc sử 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ề 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 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.

Tài liệu tham khảo về API

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