Dapatkan data artikel
Dalam aliran kerja yang memerlukan data artikel blog, anda boleh menggunakan tindakan Dapatkan data artikel untuk mengambil semula maklumat artikel daripada kedai Shopify anda.
Pada halaman ini
Konfigurasi
Medan
Tindakan Dapatkan data artikel mengandungi medan berikut:
| Medan | Penerangan |
|---|---|
| Isih data mengikut | Diperlukan. Parameter yang menetapkan bagaimana data yang dikembalikan oleh pertanyaan carian diisih. |
| Bilangan hasil maksimum | Diperlukan. Jumlah hasil maksimum yang boleh dikembalikan oleh pertanyaan carian yang anda pilih. Anda boleh mengembalikan sehingga 100 hasil pada satu-satu masa. |
| Pertanyaan | Diperlukan. Pilih daripada pertanyaan lazim atau pilih Lanjutan untuk mencipta pertanyaan anda sendiri. |
Rentetan pertanyaan
Ini ialah contoh pertanyaan untuk mendapatkan artikel yang diterbitkan pada hari sebelumnya:
published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'Pemboleh ubah published_at ialah penapis yang tersedia pada pertanyaan Artikel 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 khusus yang membolehkan anda menolak masa daripada tarikh.
Apabila menanyakan data, perkara berikut berguna untuk diketahui:
Pertanyaan mesti mengikut sintaksis tertentu
Nilai medan pertanyaan tidak sentiasa didokumenkan. Dalam sesetengah kes, nilai boleh ditemukan dengan melihat pada dokumen API. Secara alternatif, anda sering kali boleh menemukan nilai medan dalam URL dalam panel pentadbir apabila anda menapis. Sebagai contoh, untuk mencari beberapa nilai pertanyaan Pesanan, tapis halaman Pesanan dalam panel pentadbir, dan 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. Sering kali API 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 ingin menggunakan data ini dalam pelbagai cara:
- Jika anda perlu mengendalikan setiap item senarai secara berasingan, seperti 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, seperti menghantar e-mel yang mengandungi semua item, maka anda boleh menggunakan data yang dikembalikan secara langsung dalam tindakan seterusnya.
Untuk mengakses data yang dikembalikan dalam langkah yang mengikuti tindakan ini, gunakan pemboleh ubah yang bernama Dapatkan data artikel, iaitu satu senarai artikel. Anda boleh menggunakan pemboleh ubah ini dalam kedua-dua syarat dan tindakan. Sebagai contoh, anda boleh menghantar senarai artikel dalam tindakan Hantar e-mel dalaman seperti ini:
{% for single_article in GetArticleData %}
* {{ single_article.title }}
{% endfor %}Pencetus
Anda boleh menggunakan tindakan ini dalam mana-mana aliran kerja, termasuk pencetus Masa yang dijadualkan. Dalam aliran kerja yang menggunakan pencetus Masa yang dijadualkan, aliran kerja bermula pada masa yang anda tetapkan dan bukannya disebabkan peristiwa tertentu. Memandangkan tiada peristiwa khusus dalam kedai anda atau daripada aplikasi yang memulakan aliran kerja, tiada data disertakan secara automatik.
Rujukan API
Untuk mendapatkan maklumat lanjut tentang API yang digunakan dalam tindakan ini, lihat pertanyaan Articles.