Dapatkan data produk
Dalam aliran kerja yang menggunakan data produk, anda boleh menggunakan tindakan Dapatkan data produk untuk mendapatkan maklumat produk daripada kedai anda.
Pada halaman ini
Konfigurasi
Medan
Tindakan Dapatkan data produk 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 sehingga 100 hasil pada satu-satu masa. |
| Pertanyaan | Diperlukan. Pilih daripada pertanyaan biasa atau pilih Lanjutan untuk mencipta pertanyaan anda sendiri. |
Rentetan Pertanyaan
Ini ialah contoh pertanyaan untuk mendapatkan produk yang telah dikemas kini sehari yang lalu:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Pemboleh ubah updated_at ialah penapis yang tersedia pada Pertanyaan produk dan boleh digunakan berbilang kali atau digabungkan dengan pemboleh ubah lain. Pemboleh ubah Liquid scheduledAt tersedia pada aliran kerja yang menggunakan Pencetus masa dijadualkan. Tag Liquid date_minus ialah tag Flow khas yang membolehkan anda menolak masa daripada sesuatu tarikh.
Semasa membuat pertanyaan data, perkara berikut berguna untuk diketahui:
- Senarai penapis produk yang tersedia
- Pertanyaan mesti mengikut sintaks tertentu
- Nilai medan pertanyaan tidak semestinya didokumentasikan. Dalam beberapa keadaan, nilai boleh ditemukan dengan melihat dokumen API. Sebagai alternatif, anda sering dapat menemukan nilai medan dalam URL pada panel pentadbir apabila anda menapis. Contohnya, untuk mencari beberapa nilai pertanyaan Pesanan, tapis halaman Pesanan pada panel pentadbir dan kemudian semak URL tersebut.
- Anda boleh menjalankan atau menguji pertanyaan dalam kedai anda dengan menggunakan aplikasi Shopify GraphiQL.
- Ambil perhatian terhadap perkara yang berlaku jika pertanyaan anda gagal. API selalunya akan mengembalikan semua hasil (bukan tiada hasil).
Data dikembalikan
Semua tindakan Dapatkan data mengembalikan senarai antara 0 hingga 100 sumber. Bergantung pada kes penggunaan anda, anda mungkin mahu menggunakan data ini dalam pelbagai cara:
- Jika anda perlu mengendalikan setiap item senarai secara berasingan, seperti menambah tag untuk 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 perlu mengeluarkan senarai, 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 selepas tindakan ini, gunakan pemboleh ubah bernama Dapatkan data produk, iaitu senarai produk. Anda boleh menggunakan pemboleh ubah ini dalam keadaan serta tindakan. Sebagai contoh, anda boleh menghantar senarai produk dalam tindakan Hantar e-mel dalaman seperti ini:
{% for single_product in GetProductData %}
* {{ single_product.name }}
{% 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 peristiwa. Oleh sebab tiada peristiwa khusus dalam kedai anda atau daripada aplikasi yang memulakan aliran kerja tersebut, tiada data disertakan secara automatik.
Butiran API
Templat
Tambahkan produk yang mempunyai tag pada koleksi pada masa hadapan
Pada satu masa pada masa hadapan, dapatkan semua produk yang mempunyai tag tertentu dan kemudian tambahkan produk tersebut pada koleksi. Lihat templat
Padamkan produk tidak aktif
Padamkan produk tanpa inventori yang belum dikemas kini dalam masa setahun. Lihat templat
Terbitkan produk yang mempunyai tag tertentu pada masa hadapan
Pada tarikh pada masa hadapan, dapatkan produk yang mempunyai tag tertentu dan terbitkannya. Menggunakan pencetus Masa dijadualkan dan tindakan Dapatkan data produk. Lihat templat
Alih keluar tag produk baharu 90 hari selepas produk dicipta
Setiap hari, mendapatkan sehingga 100 produk yang telah dicipta lebih daripada 90 hari yang lalu dan masih mempunyai tag “baharu”. Aliran kerja itu kemudiannya mengalih keluar tag tersebut untuk setiap produk. Lihat templat
Jadualkan produk untuk dialih keluar dari Kedai Dalam Talian pada tarikh dan masa yang ditentukan
Pada satu tarikh pada masa hadapan, alih keluar produk daripada kedai dalam talian berdasarkan tag, id atau sku. Memanfaatkan pencetus Masa dijadualkan, tindakan Dapatkan Data Produk, gelung Untuk Setiap. Lihat templat
Hantar ringkasan e-mel harian yang mengandungi produk kehabisan stok
Setiap hari, mendapatkan semua produk yang mempunyai 0 inventori dan menghantar ringkasan e-mel. Menggunakan Dapatkan data produk, pencetus Masa dijadualkan. Lihat templat
Hantar pemberitahuan e-mel apabila varian ditambah dengan SKU pendua
Apabila varian baharu ditambah, menyemak sama ada terdapat varian lain yang menggunakan SKU yang sama. Jika ada, e-mel dalaman yang mengandungi pautan kepada produk dan varian yang terjejas akan dihantar. Lihat templat
Jejak varian produk yang sedang dijual menggunakan medan meta produk
Menetapkan medan meta pada produk jika sekurang-kurangnya satu daripada variannya sedang dijual. Hal ini boleh berguna untuk menjejak produk yang sedang dijual. Lihat templat