Dapatkan data diskaun

Dalam aliran kerja yang memerlukan data diskaun, anda boleh menggunakan tindakan Dapatkan data diskaun untuk mengambil semula maklumat diskaun daripada kedai anda.

Konfigurasi

Medan

Tindakan Dapatkan data diskaun 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 sehingga 100 hasil pada satu-satu masa.
PertanyaanDiperlukan. Pilih daripada pertanyaan biasa atau pilih Lanjutan untuk mencipta pertanyaan anda sendiri.

Rentetan Pertanyaan

Ini ialah contoh pertanyaan untuk mendapatkan diskaun aktif yang menggunakan kod:

method:code AND status:active

Pemboleh ubah method dan status ialah penapis yang tersedia pada Pertanyaan nod diskaun dan boleh digunakan berbilang kali atau digabungkan dengan pemboleh ubah yang lain.

Apabila membuat pertanyaan data, perkara berikut berguna untuk diketahui:

  • Senarai penapis diskaun yang tersedia.
  • Pertanyaan mesti mengikut sintaks tertentu
  • Nilai medan pertanyaan tidak sentiasa didokumenkan. Dalam sesetengah kes, nilai tersebut boleh ditemui dengan merujuk kepada dokumen API. Sebagai alternatif, anda juga boleh menemukan nilai medan di dalam URL dalam panel pentadbir apabila anda membuat penapisan. Contohnya, untuk mencari beberapa nilai pertanyaan Pesanan, tapis halaman Pesanan dalam panel pentadbir, kemudian semak URL tersebut.
  • Anda boleh menjalankan atau menguji pertanyaan di kedai anda dengan menggunakan aplikasi Shopify GraphiQL.
  • Berhati-hati dengan perkara yang berlaku jika pertanyaan anda gagal. Selalunya, API akan mengembalikan semua hasil (bukannya tiada hasil).

Data dikembalikan

Semua tindakan Dapatkan data mengembalikan senarai yang mengandungi 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 individu, seperti menambah tag untuk setiap item, anda boleh menggunakan tindakan Untuk setiap.
  • Jika anda perlu mengagregatkan data, seperti mengira bilangan hasil yang dikembalikan, anda boleh menggunakan tindakan Kira atau Jumlah.
  • Jika anda perlu mengeluarkan senarai, seperti menghantar e-mel dengan semua item tersebut, anda boleh menggunakan data yang dikembalikan secara langsung dalam tindakan yang seterusnya.

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

{% for discount_item in getDiscountData %}
{% if discount_item.discount.__typename == "DiscountAutomaticApp" %}
*  {{discount_item.discount.DiscountAutomaticApp.title}}
{% endif %}
{% endfor %}

Pencetus

Anda boleh menggunakan tindakan ini dalam mana-mana aliran kerja, termasuk pencetus Masa dijadualkan. Dalam aliran kerja yang menggunakan pencetus Masa dijadualkan, aliran kerja bermula pada masa yang telah anda tetapkan, dan bukannya hasil daripada sesuatu acara. Memandangkan tiada acara khusus di kedai anda atau daripada aplikasi yang memulakan aliran kerja, tiada data yang disertakan secara automatik.

Butiran API

Templat

E-melkan ringkasan mingguan diskaun aktif yang menggunakan kod

Menge-melkan ringkasan diskaun aktif yang menggunakan kod. Aliran kerja dijalankan mengikut jadual pada setiap hari Isnin, pukul 9 pagi. Aliran kerja boleh disesuaikan untuk menukar pemasaan, cara anda menerima ringkasan, jenis diskaun yang ingin disertakan dan mod. Lihat templat