Dapatkan data kad hadiah
Dalam aliran kerja yang memerlukan data kad hadiah, anda boleh menggunakan tindakan Dapatkan data kad hadiah untuk mengambil maklumat kad hadiah dari kedai anda.
Yang pentingnya, kedai anda mempunyai kedua-dua produk kad hadiah yang digunakan untuk menjana kad hadiah, dan kad hadiah itu sendiri, iaitu kad hadiah sebenar yang pelanggan boleh gunakan untuk membuat pembelian. Tindakan Dapatkan data kad hadiah mengambil maklumat tentang kad hadiah itu sendiri. Untuk mendapatkan maklumat tentang produk kad hadiah, gunakan tindakan Dapatkan data produk atau Dapatkan data varian produk.
Pada halaman ini
Konfigurasi
Medan
Tindakan Dapatkan data kad hadiah mengandungi medan berikut yang digunakan untuk membina pertanyaan:
| Medan | Penerangan |
|---|---|
| Isih data mengikut | Dikehendaki. Parameter untuk mengisih data yang dikembalikan oleh pertanyaan carian. |
| Bilangan hasil maksimum | Dikehendaki. Jumlah hasil maksimum yang boleh dikembalikan oleh pertanyaan carian yang anda pilih. Anda boleh mengembalikan sehingga 100 pada satu-satu masa. |
| Pertanyaan | Dikehendaki. Pilih daripada pertanyaan biasa atau pilih Lanjutan untuk mencipta pertanyaan anda sendiri. |
Rentetan Pertanyaan
Ini ialah contoh pertanyaan untuk mendapatkan kad hadiah yang dikemas kini pada hari sebelumnya:
created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'Pemboleh ubah created_at ialah penapis yang tersedia pada pertanyaan kad hadiah dan boleh digunakan beberapa kali atau digabungkan dengan pemboleh ubah yang 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 sesuatu tarikh.
Apabila menanyakan data, perkara berikut berguna untuk diketahui:
Pertanyaan mesti mengikut sintaks tertentu
Nilai medan pertanyaan tidak sentiasa didokumentasikan. Dalam beberapa kes, nilai tersebut boleh didapati dengan melihat dokumen API. Sebagai alternatif, anda juga sering mendapati nilai medan tersebut dalam URL dalam panel pentadbir apabila anda membuat penapisan. Contohnya, untuk mencari sesetengah nilai pertanyaan Pesanan, tapis halaman Pesanan dalam panel pentadbir, dan kemudian semak URL tersebut.
Anda boleh menjalankan atau menguji pertanyaan di kedai anda menggunakan aplikasi Shopify GraphiQL.
Berhati-hati dengan perkara yang berlaku sekiranya pertanyaan anda gagal. API selalunya akan mengembalikan semua hasil (bukannya tiada).
Data dikembalikan
Semua tindakan Dapatkan data mengembalikan senarai mana-mana antara 0 hingga 100 sumber. Bergantung pada kes penggunaan anda, anda mungkin mahu menggunakan data ini melalui pelbagai cara:
- Jika anda perlu mengendalikan setiap item senarai secara berasingan, seperti menambah tag untuk setiap satu, anda boleh menggunakan tindakan Untuk setiap.
- Jika anda perlu mengagregat 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, anda boleh menggunakan data yang dikembalikan secara langsung dalam tindakan seterusnya.
Untuk mengakses data yang dikembalikan dalam langkah-langkah yang mengikuti tindakan ini, gunakan pemboleh ubah bernama Dapatkan data kad hadiah, iaitu senarai kad hadiah. Anda boleh menggunakan pemboleh ubah ini dalam kedua-dua syarat dan tindakan. Sebagai contoh, anda boleh menghantar senarai kad hadiah dalam tindakan Hantar e-mel dalaman seperti ini:
{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.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.