Dapatkan data kumpulan pelan jualan
Dalam aliran kerja yang memerlukan data kumpulan pelan jualan, anda boleh menggunakan tindakan Dapatkan data kumpulan pelan jualan untuk mengambil maklumat pesanan daripada kedai anda.
Pada halaman ini
Konfigurasi
Medan
Tindakan Dapatkan data kumpulan pelan jualan mengandungi medan berikut yang digunakan untuk membina pertanyaan:
| Medan | Penerangan |
|---|---|
| Isih data mengikut | Diperlukan. Parameter yang digunakan untuk mengisih data yang dikembalikan oleh pertanyaan carian. |
| Bilangan maksimum hasil | Diperlukan. Jumlah maksimum hasil yang boleh dikembalikan oleh pertanyaan carian yang anda pilih. Anda boleh mengembalikan hingga 100 pada satu masa. |
| Pertanyaan | Diperlukan. Pilih daripada pertanyaan biasa atau pilih Lanjutan untuk mencipta pertanyaan anda sendiri. |
Rentetan Pertanyaan
Ini ialah contoh pertanyaan untuk mendapatkan kumpulan pelan jualan yang dikemas kini pada hari lalu:
name='Subscribe & Save'Pemboleh ubah category ialah penapis yang tersedia pada Pertanyaan kumpulan pelan jualan dan boleh digunakan untuk memilih kategori kumpulan pelan jualan yang khusus.
Apabila membuat pertanyaan data, perkara berikut berguna untuk diketahui:
- Senarai penapis kumpulan pelan jualan 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 individu, seperti untuk menambah tag bagi setiap item, maka anda boleh menggunakan tindakan Untuk setiap.
- Jika anda perlu mengagregatkan data, seperti mengira bilangan hasil yang dikembalikan, maka anda boleh menggunakan tindakan Kira atau Jumlah.
- Jika anda memerlukan senarai output, seperti menghantar e-mel bersama semua item, maka anda boleh menggunakan data yang dikembalikan secara langsung dalam tindakan berikutnya.
Untuk mengakses data yang dikembalikan dalam langkah yang mengikuti tindakan ini, gunakan pemboleh ubah bernama Dapatkan data kumpulan pelan jualan, yang merupakan senarai kumpulan pelan jualan. Anda boleh menggunakan pemboleh ubah ini dalam keadaan dan tindakan. Sebagai contoh, anda boleh menghantar senarai kumpulan pelan jualan dalam tindakan Hantar e-mel dalaman seperti ini:
{% for getSellingPlanGroupData_item in getSellingPlanGroupData %}
{{getSellingPlanGroupData_item.name}}
{% endfor %}Contoh
Sebagai contoh, aliran kerja dijadualkan untuk dijalankan pada hari Ahad jam 9:00 pagi. Tindakan Dapatkan data kumpulan pelan jualan digunakan untuk mengumpulkan data kumpulan pelan jualan yang dicipta pada minggu lepas. Jika produk yang dikaitkan dengan kumpulan pelan jualan tersebut merupakan jualan terbaik anda, maka kedudukan position kumpulan pelan jualan tersebut boleh meningkat.