Bantuan
Log masuk

Dapatkan data lokasi syarikat

Dalam aliran kerja yang menggunakan data lokasi syarikat, anda boleh menggunakan tindakan Dapatkan data lokasi syarikat untuk mengambil maklumat lokasi syarikat daripada kedai anda.

Pada halaman ini

Konfigurasi

Medan

Tindakan Dapatkan data lokasi syarikat mengandungi medan berikut, yang digunakan untuk membina pertanyaan:

Medan yang digunakan dalam tindakan Dapatkan data.
MedanPenerangan
Susun data mengikutDiperlukan. Parameter yang digunakan untuk menyusun data yang dikembalikan oleh pertanyaan carian.
Bilangan hasil maksimumDiperlukan. Jumlah hasil maksimum yang boleh dikembalikan oleh pertanyaan carian yang anda pilih. Anda boleh mengembalikan hingga 100 pada satu masa.
PertanyaanDiperlukan. Pilih daripada pertanyaan lazim atau pilih Terperinci untuk mencipta pertanyaan anda sendiri.

Rentetan Pertanyaan

Ini ialah contoh pertanyaan untuk mendapatkan lokasi syarikat yang telah dikemas kini pada hari lalu:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Pemboleh ubah updated_at ialah penapis yang tersedia pada pertanyaan Lokasi syarikat dan boleh digunakan berbilang kali atau digabungkan dengan pemboleh ubah lain. Pemboleh ubah Liquid scheduledAt tersedia pada aliran kerja yang menggunakan pencetus Masa dijadualkan. Tag Liquid date_minus ialah tag Flow khas yang membolehkan anda menolak masa daripada tarikh.

Apabila membuat pertanyaan data, adalah berguna untuk mengetahui:

  • Senarai penapis lokasi syarikat yang tersedia
  • Pertanyaan mesti mengikut sintaks tertentu
  • Nilai medan pertanyaan tidak semestinya didokumentasikan. Dalam sesetengah kes, nilai tersebut boleh ditemui dengan merujuk pada dokumen API. Sebagai alternatif, anda juga sering kali boleh mencari nilai medan dalam URL pada panel pentadbir apabila anda menapis. Sebagai contoh, untuk mencari beberapa nilai pertanyaan Pesanan, tapis halaman Pesanan pada panel 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 sekiranya pertanyaan anda gagal. API sering kali akan mengembalikan semua hasil (dan bukannya tiada hasil langsung).

Data yang dikembalikan

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

  • Jika anda perlu mengendalikan setiap item senarai secara berasingan, seperti menambah tag untuk setiap item, 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, seperti menghantar e-mel yang mengandungi 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 bernama Dapatkan data lokasi syarikat, yang merupakan senarai lokasi syarikat. Anda boleh menggunakan pemboleh ubah ini dalam keadaan serta tindakan. Sebagai contoh, anda boleh menghantar senarai lokasi dalam tindakan Hantar e-mel dalaman seperti ini:

{% for single_company in GetCompanyLocationData %}
* {{ single_company.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, bukannya akibat daripada peristiwa. Oleh sebab tiada peristiwa khusus dalam kedai anda atau daripada aplikasi yang memulakan aliran kerja tersebut, tiada data yang disertakan secara automatik.

Rujukan API