Dapatkan data lokasi

Dalam aliran kerja yang memerlukan data lokasi, anda boleh menggunakan tindakan Dapatkan data lokasi untuk mendapatkan maklumat lokasi daripada kedai Shopify anda. Lokasi ialah sebarang tempat anda menyimpan inventori, menjual produk, atau mengirim atau memenuhi pesanan.

Pada halaman ini

Konfigurasi

Medan

Tindakan Dapatkan data lokasi 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. Jumlah 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 pertanyaan contoh untuk mendapatkan lokasi yang mendayakan ambil di kedai:

pickup_in_store:enabled

Pemboleh ubah pickup_in_store ialah penapis yang tersedia pada Pertanyaan lokasi dan boleh digunakan berkali-kali atau digabungkan dengan pemboleh ubah lain.

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

Senarai penapis lokasi yang tersedia
Pertanyaan mesti mengikut sintaks tertentu
Nilai medan pertanyaan tidak sentiasa didokumentasikan. Dalam sesetengah keadaan, nilai tersebut boleh didapati dengan merujuk pada dokumen API. Sebagai alternatif, anda juga boleh menemui nilai medan dalam URL dalam Pentadbir semasa anda membuat penapisan. Contohnya, untuk mencari beberapa nilai pertanyaan Pesanan, tapis halaman Pesanan dalam Pentadbir, kemudian semak URL tersebut.
Anda boleh menjalankan atau menguji pertanyaan di kedai anda dengan menggunakan aplikasi Shopify GraphiQL.
Beri perhatian tentang perkara yang berlaku jika pertanyaan anda gagal. Selalunya API akan mengembalikan semua hasil (dan bukannya tiada hasil).

Data dikembalikan

Semua tindakan Dapatkan data mengembalikan senarai antara 0 hingga 100 sumber. Bergantung pada keadaan penggunaan anda, anda mungkin ingin menggunakan data ini dalam pelbagai cara:

Jika anda perlu mengendalikan setiap item senarai secara individu, seperti untuk menambah tag pada 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 perlu mengeluarkan senarai tersebut, seperti menghantar e-mel yang mengandungi semua item, anda boleh menggunakan data yang dikembalikan secara langsung dalam tindakan yang seterusnya.

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

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% 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 telah anda tetapkan, dan bukannya hasil daripada sesuatu 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 mengenai API yang digunakan dalam tindakan ini, lihat Pertanyaan lokasi.