Trợ giúp
Đăng nhập

Lấy dữ liệu lần thử thanh toán đăng ký

Trong các dòng công việc yêu cầu dữ liệu về lần thử thanh toán đăng ký, bạn có thể dùng hành động Lấy dữ liệu lần thử thanh toán đăng ký để truy xuất thông tin đơn hàng từ cửa hàng của mình.

Trên trang này

Cấu hình

Các trường

Hành động Lấy dữ liệu lần thử thanh toán đăng ký bao gồm các trường sau dùng để tạo truy vấn:

Các trường dùng trong hành động Lấy dữ liệu.
TrườngMô tả
Sắp xếp dữ liệu theoBắt buộ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 đaBắ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ể 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 của riêng bạn.

Chuỗi truy vấn

Đây là truy vấn ví dụ để lấy các lần thử thanh toán đăng ký đã tạo trong ba ngày qua:

created_at:>'{{ createdAt | date_minus: "3 day" }}'

Biến created_at là bộ lọc trong truy vấn lần thử thanh toán đăng ký và có thể dùng để chọn thông báo lỗi cụ thể đối với các lần thử thanh toán đăng ký.

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 lần thử thanh toán đăng ký 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ó sẵn 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 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 các URL của 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 ứng dụng Shopify GraphiQL.
  • Lưu ý điều sẽ xảy ra nếu truy vấn không thành công. Thường thì 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 hành động 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ể 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 hành động 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 hành động Đếm hoặc 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 hành động tiếp theo.

Để truy cập dữ liệu trả về trong các bước sau hành động này, hãy sử dụng biến có tên Lấy dữ liệu lần thử thanh toán cho gói đăng ký, đây là danh sách các lần thử thanh toán cho gói đăng ký. Bạn có thể sử dụng biến này trong cả điều kiện và hành động. Ví dụ: bạn có thể gửi danh sách lần thử thanh toán cho gói đăng ký trong hành động Gửi email nội bộ như sau:

{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
  {{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}

Ví dụ

Ví dụ: một dòng công việc được lên lịch chạy vào 9:00 sáng Chủ Nhật hàng tuần. Hành động Lấy dữ liệu lần thử thanh toán cho gói đăng ký được sử dụng để thu thập dữ liệu về các lần thử thanh toán cho gói đăng ký được tạo trong tuần qua. Nếu có thông báo lỗi, hãy gửi email thông báo về các lần thử thanh toán này.

Tham khảo API