Dapatkan data pasar

Dalam alur kerja yang memerlukan data pasar, Anda dapat menggunakan tindakan Dapatkan data pasar untuk mengambil informasi pasar dari toko Shopify Anda. Pasar adalah grup wilayah atau lokasi yang menjadi target penjualan Anda.

Di halaman ini

Konfigurasi

Bidang

Tindakan Dapatkan data pasar berisi bidang berikut:

Bidang yang digunakan dalam tindakan Dapatkan data.
Bidang	Deskripsi
Urutkan data berdasarkan	Wajib. Parameter yang digunakan untuk mengurutkan data yang dikembalikan oleh kueri pencarian.
Jumlah hasil maksimum	Wajib. Jumlah hasil maksimum yang dapat dikembalikan oleh kueri pencarian yang Anda pilih. Anda dapat mengembalikan hingga 100 sekaligus.
Kueri	Wajib. Pilih dari kueri umum atau pilih Lanjutan untuk membuat kueri Anda sendiri.

String kueri

Berikut adalah contoh kueri untuk mendapatkan semua pasar yang aktif:

status:ACTIVE

Variabel status adalah filter yang tersedia di kueri Pasar dan dapat digunakan beberapa kali atau digabungkan dengan variabel lain.

Saat membuat kueri data, Anda perlu mengetahui hal berikut:

Daftar filter pasar yang tersedia
Kueri harus mengikuti sintaksis tertentu
Nilai kolom kueri tidak selalu didokumentasikan. Dalam beberapa kasus, nilai tersebut dapat ditemukan dengan melihat dokumentasi API. Selain itu, Anda sering dapat menemukan nilai kolom di URL pada admin saat memfilter. Contohnya, untuk menemukan beberapa nilai kueri Pesanan, filter halaman Pesanan di admin, lalu periksa URL-nya.
Anda dapat menjalankan atau menguji kueri di toko Anda menggunakan aplikasi Shopify GraphiQL.
Harap perhatikan hal yang terjadi jika kueri Anda gagal. API sering kali akan mengembalikan semua hasil (bukan tidak mengembalikan apa pun).

Data yang dikembalikan

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

Jika Anda perlu menangani setiap item daftar secara terpisah, misalnya menambahkan tag ke masing-masing item, Anda dapat menggunakan tindakan Untuk setiap.
Jika Anda perlu mengagregasi data, misalnya menghitung jumlah hasil yang dikembalikan, Anda dapat menggunakan tindakan Hitung atau Jumlah.
Jika Anda perlu menampilkan daftar tersebut, misalnya untuk mengirim email berisi semua item, Anda dapat langsung menggunakan data yang dikembalikan pada tindakan berikutnya.

Untuk mengakses data yang dikembalikan pada langkah-langkah setelah tindakan ini, gunakan variabel bernama Dapatkan data pasar, yang merupakan sebuah daftar pasar. Anda dapat menggunakan variabel ini pada kondisi dan tindakan. Contohnya, Anda dapat mengirimkan daftar pasar dalam tindakan Kirim email internal yang serupa dengan berikut:

{% for single_market in GetMarketData %}
    * {{ single_market.name }}
    {% endfor %}

Pemicu

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

Referensi API

Untuk informasi lebih lanjut tentang API yang digunakan pada tindakan ini, lihat kueri Pasar.