Bantuan
Masuk

Ambil data percobaan penagihan langganan

Dalam alur kerja yang memerlukan data percobaan penagihan langganan, Anda dapat menggunakan tindakan Ambil data percobaan penagihan langganan untuk mengambil informasi pesanan dari toko Anda.

Di halaman ini

Konfigurasi

Kolom

Tindakan Ambil data percobaan penagihan langganan berisi kolom berikut, yang digunakan untuk membuat kueri:

Kolom yang digunakan dalam tindakan Ambil data.
KolomDeskripsi
Urutkan data menurutWajib diisi. Parameter yang digunakan untuk mengurutkan data yang dikembalikan oleh kueri pencarian.
Jumlah hasil maksimumWajib diisi. Jumlah hasil maksimum yang dapat dikembalikan oleh kueri pencarian yang Anda pilih. Anda dapat mengembalikan hingga 100 hasil sekaligus.
KueriWajib diisi. Pilih dari kueri umum atau pilih Lanjutan untuk membuat kueri Anda sendiri.

String Kueri

Ini adalah contoh kueri untuk mendapatkan percobaan penagihan langganan yang dibuat dalam tiga hari terakhir:

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

Variabel created_at adalah filter yang tersedia di kueri percobaan penagihan langganan dan dapat digunakan untuk memilih pesan eror tertentu untuk percobaan penagihan langganan.

Saat membuat kueri data, ada baiknya Anda mengetahui:

  • Daftar filter percobaan penagihan langganan yang tersedia
  • Kueri harus mengikuti sintaksis tertentu
  • Nilai kolom kueri tidak selalu didokumentasikan. Dalam beberapa kasus, nilainya dapat ditemukan dengan melihat dokumen API. Atau, Anda sering kali dapat menemukan nilai kolom di URL pada panel admin saat memfilter. Misalnya, untuk menemukan beberapa nilai kueri Pesanan, filter halaman Pesanan di panel admin, lalu periksa URL.
  • Anda dapat menjalankan atau menguji kueri di toko Anda dengan menggunakan aplikasi Shopify GraphiQL.
  • Perhatikan apa yang terjadi jika kueri Anda gagal. Sering kali, API akan mengembalikan semua hasil (bukan tidak sama sekali).

Data yang dikembalikan

Semua tindakan Dapatkan data mengembalikan daftar yang berisi 0 hingga 100 sumber daya. Tergantung pada kasus penggunaan Anda, Anda mungkin ingin menggunakan data ini dengan berbagai cara:

  • Jika Anda perlu menangani setiap item daftar satu per satu, misalnya untuk menambahkan tag ke setiap item, Anda dapat menggunakan tindakan Untuk setiap.
  • Jika Anda perlu mengagregasi data, seperti menghitung berapa banyak hasil yang dikembalikan, Anda dapat menggunakan tindakan Hitung atau Jumlahkan.
  • Jika Anda perlu menampilkan daftar sebagai output, misalnya mengirim email berisi semua item, Anda dapat menggunakan data yang dikembalikan secara langsung dalam tindakan berikutnya.

Untuk mengakses data yang dikembalikan dalam langkah-langkah setelah tindakan ini, gunakan variabel bernama Dapatkan data percobaan penagihan langganan, yang merupakan daftar percobaan penagihan langganan. Anda dapat menggunakan variabel ini dalam kondisi dan tindakan. Misalnya, Anda dapat mengirim daftar percobaan penagihan langganan dalam tindakan Kirim email internal seperti ini:

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

Contoh

Misalnya, alur kerja dijadwalkan untuk berjalan setiap hari Minggu pukul 9.00. Tindakan Dapatkan data percobaan penagihan langganan digunakan untuk mengumpulkan data percobaan penagihan langganan yang dibuat dalam seminggu terakhir. Jika ada pesan error, percobaan penagihan akan di-email.

Referensi API