Dapatkan data pasaran

Dalam aliran kerja yang memerlukan data pasaran, anda boleh menggunakan tindakan Dapatkan data pasaran untuk mendapatkan maklumat pasaran daripada kedai Shopify anda. Pasaran ialah kumpulan rantau atau lokasi yang anda sasarkan untuk jualan.

Pada halaman ini

Konfigurasi

Medan

Tindakan Dapatkan data pasaran mengandungi medan yang berikut:

Medan yang digunakan dalam tindakan Dapatkan data.
Medan	Perihalan
Isih data mengikut	Diperlukan. Parameter yang digunakan untuk mengisih data yang dikembalikan oleh pertanyaan carian.
Bilangan maksimum hasil	Diperlukan. Amaun maksimum hasil yang boleh dikembalikan oleh pertanyaan carian yang anda pilih. Anda boleh mengembalikan hingga 100 hasil pada satu masa.
Pertanyaan	Diperlukan. Pilih daripada pertanyaan biasa atau pilih Lanjutan untuk mencipta pertanyaan anda sendiri.

Rentetan pertanyaan

Ini ialah contoh pertanyaan untuk mendapatkan semua pasaran yang aktif:

status:ACTIVE

Pemboleh ubah status ialah penapis yang tersedia pada Pertanyaan Markets dan boleh digunakan beberapa kali atau digabungkan dengan pemboleh ubah lain.

Apabila membuat pertanyaan data, perkara berikut amat berguna untuk diketahui:

Senarai penapis pasaran yang tersedia
Pertanyaan mesti mengikut sintaks tertentu
Nilai medan pertanyaan tidak semestinya didokumentasikan. Dalam sesetengah kes, nilai tersebut boleh didapati dengan merujuk pada dokumen API. Sebagai alternatif, anda juga sering kali boleh menemukan nilai medan dalam URL di pentadbir apabila anda membuat penapisan. Contohnya, untuk mencari sesetengah nilai pertanyaan Pesanan, tapis halaman Pesanan dalam pentadbir, dan kemudian semak URL tersebut.
Anda boleh menjalankan atau menguji pertanyaan dalam kedai anda dengan menggunakan aplikasi Shopify GraphiQL.
Berhati-hati dengan perkara yang berlaku jika pertanyaan anda gagal. API selalunya akan mengembalikan semua hasil (bukan tiada hasil).

Data yang dikembalikan

Semua tindakan Dapatkan data mengembalikan senarai dari 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 untuk menambah tag bagi setiap satunya, 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 tersebut, 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 dinamakan Dapatkan data pasaran, yang merupakan senarai pasaran. Anda boleh menggunakan pemboleh ubah ini dalam keadaan dan tindakan. Contohnya, anda boleh menghantar senarai pasaran dalam tindakan Hantar e-mel dalaman yang serupa dengan ini:

{% for single_market in GetMarketData %}
    * {{ single_market.name }}
    {% 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 telah anda tetapkan, dan bukannya hasil daripada sesuatu acara. Oleh sebab tiada acara khusus dalam kedai anda atau daripada aplikasi yang memulakan aliran kerja tersebut, tiada data disertakan secara automatik.

Rujukan API

Untuk mendapatkan maklumat lanjut tentang API yang digunakan dalam tindakan ini, lihat Pertanyaan Markets.