Bantuan
Log masuk

Dapatkan data cubaan pengebilan langganan

Dalam aliran kerja yang memerlukan data cubaan pengebilan langganan, anda boleh menggunakan tindakan Dapatkan data cubaan pengebilan langganan untuk mengambil semula maklumat pesanan daripada kedai anda.

Pada halaman ini

Konfigurasi

Medan

Tindakan Dapatkan data cubaan pengebilan langganan mengandungi medan berikut yang digunakan untuk membina pertanyaan:

Medan yang digunakan dalam tindakan Dapatkan data.
MedanPenerangan
Isih data mengikutDiperlukan. Parameter yang digunakan untuk mengisih data yang dikembalikan oleh pertanyaan carian.
Bilangan maksimum hasilDiperlukan. Jumlah maksimum hasil yang boleh dikembalikan oleh pertanyaan carian yang anda pilih. Anda boleh mengembalikan hingga 100 pada satu masa.
PertanyaanDiperlukan. Pilih daripada pertanyaan biasa atau pilih Lanjutan untuk mencipta pertanyaan anda sendiri.

Rentetan Pertanyaan

Ini ialah contoh pertanyaan untuk mendapatkan cubaan pengebilan langganan yang dicipta pada tiga hari lepas:

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

Pemboleh ubah created_at ialah penapis yang tersedia pada pertanyaan cubaan pengebilan langganan dan boleh digunakan untuk memilih mesej ralat khusus bagi cubaan pengebilan langganan.

Apabila membuat pertanyaan data, perkara berikut berguna untuk diketahui:

  • Senarai penapis cubaan pengebilan langganan yang tersedia
  • Pertanyaan mesti mengikut sintaks tertentu
  • Nilai medan pertanyaan tidak semestinya didokumentasikan. Dalam sesetengah kes, nilai tersebut boleh ditemui dengan merujuk pada dokumen API. Sebagai alternatif, anda juga sering kali boleh mencari nilai medan dalam URL pada panel pentadbir apabila anda menapis. Sebagai contoh, untuk mencari beberapa nilai pertanyaan Pesanan, tapis halaman Pesanan dalam panel pentadbir, kemudian semak URL.
  • Anda boleh menjalankan atau menguji pertanyaan di kedai anda menggunakan aplikasi Shopify GraphiQL.
  • Berwaspada akan perkara yang berlaku jika pertanyaan anda gagal. Selalunya API akan mengembalikan semua hasil (bukan tiada hasil).

Data yang dikembalikan

Semua tindakan Dapatkan data mengembalikan senarai dengan mana-mana 0 hingga 100 sumber. Bergantung pada kes penggunaan, anda mungkin mahu menggunakan data ini dalam pelbagai cara:

  • Jika anda perlu mengendalikan setiap item senarai secara berasingan, seperti untuk menambah tag bagi setiap item, maka anda boleh menggunakan tindakan Untuk setiap.
  • Jika anda perlu mengagregat data, seperti mengira bilangan hasil yang dikembalikan, maka anda boleh menggunakan tindakan Kira atau Jumlah.
  • Jika anda perlu mengeluarkan senarai tersebut, seperti menghantar e-mel yang mengandungi semua item, maka anda boleh menggunakan data yang dikembalikan secara terus dalam tindakan yang seterusnya.

Untuk mengakses data yang dikembalikan dalam langkah yang mengikuti tindakan ini, gunakan pemboleh ubah bernama Dapatkan data cubaan pengebilan langganan, iaitu senarai cubaan pengebilan langganan. Anda boleh menggunakan pemboleh ubah ini dalam keadaan dan tindakan. Contohnya, anda boleh menghantar senarai cubaan pengebilan langganan dalam tindakan Hantar e-mel dalaman seperti ini:

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

Contoh

Contohnya, aliran kerja dijadualkan untuk dijalankan pada setiap hari Ahad jam 9:00 pagi. Tindakan Dapatkan data cubaan pengebilan langganan digunakan untuk mengumpulkan data bagi cubaan pengebilan langganan yang dicipta pada minggu lepas. Jika terdapat mesej ralat, maka hantar e-mel tentang cubaan pengebilan tersebut.

Rujukan API