Dapatkan data kartu hadiah

Dalam alur kerja yang memerlukan data kartu hadiah, Anda dapat menggunakan tindakan Dapatkan data kartu hadiah untuk mengambil informasi kartu hadiah dari toko Anda.

Penting untuk diketahui, toko Anda memiliki produk kartu hadiah, yang digunakan untuk membuat kartu hadiah, dan kartu hadiah itu sendiri, yaitu kartu hadiah aktual yang dapat digunakan pelanggan untuk melakukan pembelian. Tindakan Dapatkan data kartu hadiah mengambil informasi tentang kartu hadiah itu sendiri. Untuk mendapatkan informasi tentang produk kartu hadiah, gunakan tindakan Dapatkan data produk atau Dapatkan data varian produk.

Konfigurasi

Kolom

Tindakan Dapatkan data kartu hadiah berisi kolom berikut, yang digunakan untuk menyusun kueri:

String Kueri

Berikut adalah contoh kueri untuk mendapatkan kartu hadiah yang diperbarui dalam satu hari terakhir:

created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Variabel created_at adalah filter yang tersedia di kueri kartu hadiah dan dapat digunakan beberapa kali atau digabungkan dengan variabel lain. Variabel Liquid scheduledAt tersedia di alur kerja yang menggunakan pemicu Waktu terjadwal. Tag Liquid date_minus adalah tag Flow khusus yang memungkinkan Anda mengurangi waktu dari tanggal.

Saat membuat kueri data, ada baiknya Anda mengetahui:

• Daftar filter kartu hadiah yang tersedia

• Kueri harus mengikuti sintaksis tertentu

• Nilai kolom kueri tidak selalu didokumentasikan. Dalam beberapa kasus, nilai dapat ditemukan dengan melihat dokumen API. Atau, Anda sering kali dapat menemukan nilai kolom di URL pada panel admin saat Anda memfilter. Misalnya, untuk menemukan beberapa nilai kueri Pesanan, filter halaman Pesanan di panel admin, lalu periksa URL.

• Anda dapat menjalankan atau menguji kueri di toko Anda dengan menggunakan aplikasi Shopify GraphiQL.

• Perhatikan apa yang terjadi jika kueri Anda gagal. Sering kali, API akan menampilkan semua hasil (alih-alih tidak ada).

Data yang dikembalikan

Semua tindakan Ambil data menampilkan daftar berisi 0 hingga 100 sumber daya. Tergantung pada kasus penggunaan Anda, Anda mungkin ingin menggunakan data ini dengan berbagai cara:

• Jika Anda perlu menangani setiap item daftar secara individual, seperti untuk menambahkan tag pada setiap item, Anda dapat menggunakan tindakan Untuk setiap.
• Jika Anda perlu mengagregasi data, seperti menghitung berapa banyak hasil yang dikembalikan, Anda dapat menggunakan tindakan Hitung atau Jumlahkan.
• Jika Anda perlu mengeluarkan daftar, seperti mengirim email yang berisi semua item, Anda dapat langsung menggunakan data yang dikembalikan dalam tindakan-tindakan selanjutnya.

Untuk mengakses data yang dikembalikan dalam langkah-langkah setelah tindakan ini, gunakan variabel bernama Ambil data kartu hadiah, yang merupakan daftar kartu hadiah. Anda dapat menggunakan variabel ini dalam kondisi dan tindakan. Misalnya, Anda dapat mengirim daftar kartu hadiah dalam tindakan Kirim email internal seperti ini:

{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}

Pemicu

Anda dapat menggunakan tindakan ini di alur kerja apa pun, termasuk pemicu Waktu terjadwal. Dalam alur kerja yang menggunakan pemicu Waktu terjadwal, alur kerja dimulai pada waktu yang telah Anda tentukan, bukan sebagai akibat dari suatu peristiwa. Karena tidak ada peristiwa spesifik di toko Anda atau dari aplikasi yang memulai alur kerja, tidak ada data yang disertakan secara otomatis.

Detail API

• Sumber daya kartu hadiah
• Filter kueri kartu hadiah