Dapatkan data katalog

Dalam aliran kerja yang memerlukan data katalog, anda boleh menggunakan tindakan Dapatkan data katalog untuk mengambil maklumat katalog B2B dari kedai anda. Katalog ialah kumpulan produk dengan penetapan harga yang disesuaikan untuk pelanggan B2B atau lokasi syarikat tertentu.

Pada halaman ini

Konfigurasi

Medan

Tindakan Dapatkan data katalog mengandungi medan yang berikut:

Medan yang digunakan dalam tindakan Dapatkan data.
Medan	Penerangan
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 sehingga 100 hasil pada satu-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 katalog aktif:

status:ACTIVE

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

Apabila menanyakan data, perkara yang berikut berguna untuk diketahui:

Senarai penapis katalog yang tersedia
Pertanyaan mesti mengikut sintaks tertentu
Nilai medan pertanyaan tidak sentiasa didokumenkan. Dalam sesetengah kes, nilai tersebut boleh didapati dengan melihat pada dokumen API. Secara alternatif, anda sering kali boleh mencari nilai medan dalam URL pada pentadbir apabila anda menapis. Sebagai contoh, untuk mencari sesetengah nilai pertanyaan Pesanan, tapis halaman Pesanan pada pentadbir dan kemudian semak URL tersebut.
Anda boleh menjalankan atau menguji pertanyaan dalam kedai anda dengan menggunakan aplikasi Shopify GraphiQL.
Peka akan perkara yang berlaku jika pertanyaan anda gagal. API sering kali akan mengembalikan semua hasil (bukannya tidak mengembalikan apa-apa 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 menambah tag untuk setiap satu daripadanya, maka anda boleh menggunakan tindakan Untuk setiap.
Jika anda perlu mengagregatkan data, seperti mengira bilangan hasil yang dikembalikan, maka anda boleh menggunakan tindakan Kira atau Jumlah.
Jika anda perlukan output senarai, seperti menghantar e-mel dengan semua item, maka anda boleh menggunakan data yang dikembalikan secara terus dalam tindakan yang seterusnya.

Untuk mengakses data yang dikembalikan dalam langkah-langkah yang mengikuti tindakan ini, gunakan pemboleh ubah yang bernama Dapatkan data katalog, iaitu senarai katalog. Anda boleh menggunakan pemboleh ubah ini dalam kedua-dua syarat dan tindakan. Sebagai contoh, anda boleh menghantar senarai katalog dalam tindakan Hantar e-mel dalaman seperti ini:

{% for single_catalog in getCatalogData %}
  * {{ single_catalog.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 telah anda tentukan, bukannya sebagai akibat daripada suatu peristiwa. Oleh sebab tiada peristiwa 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 katalog.