Dapatkan data halaman

Dalam aliran kerja yang memerlukan data halaman, anda boleh menggunakan tindakan Dapatkan data halaman untuk mendapatkan maklumat halaman daripada kedai anda. Halaman ialah halaman web di kedai dalam talian anda yang mengandungi maklumat yang jarang berubah, seperti halaman Perihal Kami atau halaman Hubungi.

Pada halaman ini

Konfigurasi

Medan

Tindakan Dapatkan data halaman mengandungi medan 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. Jumlah maksimum hasil yang boleh dikembalikan oleh pertanyaan carian yang anda pilih. Anda boleh mengembalikan sehingga 100 pada satu masa.
Pertanyaan	Diperlukan. Pilih daripada pertanyaan biasa atau pilih Lanjutan untuk membuat pertanyaan anda sendiri.

Rentetan pertanyaan

Ini ialah contoh pertanyaan untuk mendapatkan halaman yang diterbitkan:

published_status:published

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

Apabila menanyakan data, berguna untuk mengetahui perkara berikut:

Senarai penapis halaman yang tersedia
Pertanyaan mesti mengikut sintaks tertentu
Nilai medan pertanyaan tidak semestinya didokumentasikan. Dalam sesetengah kes, nilai boleh didapati dengan melihat dokumen API. Sebagai alternatif, anda sering dapat menemukan nilai medan dalam URL dalam panel pentadbir apabila anda menapis. Sebagai contoh, untuk mencari beberapa nilai pertanyaan Pesanan, tapis halaman Pesanan dalam panel pentadbir dan kemudian semak URL.
Anda boleh menjalankan atau menguji pertanyaan dalam kedai anda dengan menggunakan aplikasi Shopify GraphiQL.
Sila ambil perhatian tentang perkara yang berlaku jika pertanyaan anda gagal. Selalunya, API akan mengembalikan semua hasil (bukan tiada).

Data yang dikembalikan

Semua tindakan Dapatkan data mengembalikan senarai sumber daripada 0 hingga 100. Bergantung pada kes penggunaan anda, anda mungkin mahu menggunakan data ini dalam pelbagai cara:

Jika anda perlu mengendalikan setiap item senarai secara individu, seperti untuk menambahkan tag bagi setiap satu, anda boleh menggunakan tindakan Untuk setiap.
Jika anda perlu mengagregatkan data, seperti mengira bilangan hasil yang dikembalikan, anda boleh menggunakan tindakan Kira atau Jumlah.
Jika anda perlu mengeluarkan senarai tersebut, 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 yang mengikuti tindakan ini, gunakan pemboleh ubah bernama Dapatkan data halaman, yang merupakan senarai halaman. Anda boleh menggunakan pemboleh ubah ini dalam kedua-dua syarat dan tindakan. Sebagai contoh, anda boleh menghantar senarai halaman dalam tindakan Hantar e-mel dalaman seperti ini:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% 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 anda tetapkan, bukan hasil daripada peristiwa. Oleh sebab tiada peristiwa khusus dalam kedai anda atau daripada aplikasi yang memulakan aliran kerja, tiada data disertakan secara automatik.

Rujukan API

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