Dohvati podatke o lokaciji poduzeća

U tijekovima rada koji upotrebljavaju podatke o lokaciji poduzeća možete upotrijebiti radnju Dohvati podatke o lokaciji poduzeća kako biste iz svoje trgovine pronašli informacije o lokaciji poduzeća.

Konfiguracija

Polja

Radnja Dohvati podatke o lokaciji poduzeća sadrži sljedeća polja koja se upotrebljavaju za izradu upita:

Polja koja se upotrebljavaju u radnjama Dohvati podatke.
PoljeOpis
Razvrstaj podatke premaObavezno. Parametri prema kojima se razvrstavaju podaci koje je vratio upit za pretraživanje.
Maksimalni broj rezultataObavezno. Maksimalni broj rezultata koje može vratiti upit za pretraživanje koji odaberete. Odjednom se može vratiti do 100 rezultata.
UpitObavezno. Odaberite među uobičajenim upitima ili odaberite Napredno kako biste izradili vlastiti.

Niz upita

Ovo je primjer upita za dohvaćanje lokacija poduzeća koje su ažurirane tijekom posljednjeg dana:

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

Varijabla updated_at jest filtar dostupan u upitu za lokacije poduzeća i može se upotrijebiti više puta ili u kombinaciji s drugim varijablama. Varijabla Liquid scheduledAt dostupna je u tijekovima rada koji su upotrebljavali pokretač Zakazano vrijeme. Oznaka Liquid date_minus posebna je oznaka za aplikaciju Flow koja vam omogućuje oduzimanje vremena od datuma.

Pri izradi upita za podatke korisno je znati sljedeće:

  • Popis dostupnih filtara lokacije poduzeća
  • Upiti moraju slijediti određenu sintaksu
  • Vrijednosti polja upita nisu uvijek dokumentirane. U nekim se slučajevima te vrijednosti mogu pronaći pregledom dokumentacije API-ja. Alternativno, prilikom filtriranja vrijednosti polja često možete pronaći u URL-ovima u administratorskoj ploči. Na primjer, za pronalaženje nekih vrijednosti upita za narudžbu filtrirajte stranicu Narudžbe u administratorskoj ploči, a zatim provjerite URL.
  • Upit u svojoj trgovini možete pokrenuti ili testirati s pomoću aplikacije Shopify GraphiQL.
  • Pripazite na to što se događa ako vaš upit ne uspije. API će često vratiti sve rezultate (umjesto nijednog).

Vraćeni podaci

Sve radnje Dohvati podatke vraćaju popis od 0 do 100 resursa. Ovisno o vašem slučaju upotrebe, te podatke možda želite upotrebljavati na različite načine:

  • Ako trebate pojedinačno rukovati svakom stavkom na popisu, primjerice kako biste svakoj dodali oznaku, tada možete upotrijebiti radnju Za svaki.
  • Ako trebate agregirati podatke, primjerice izbrojati koliko je rezultata vraćeno, možete upotrijebiti radnju Broj ili Zbroj.
  • Ako trebate izvesti popis, primjerice poslati e-poruku sa svim stavkama, tada vraćene podatke možete izravno upotrijebiti u narednim radnjama.

Za pristup vraćenim podacima u koracima koji slijede ovu radnju upotrijebite varijablu pod nazivom Dohvati podatke o lokaciji poduzeća, koja predstavlja popis lokacija poduzeća. Tu varijablu možete upotrijebiti i u uvjetima i u radnjama. Na primjer, popis lokacija možete poslati u radnji Pošalji internu e-poruku ovako:

{% for single_company in GetCompanyLocationData %}
* {{ single_company.name }}
{% endfor %}

Pokretači

Ovu radnju možete upotrijebiti u bilo kojem tijeku rada, uključujući pokretač Zakazano vrijeme. U tijeku rada koji upotrebljava pokretač Zakazano vrijeme, tijek rada započinje u vrijeme koje ste odredili, a ne kao rezultat događaja. S obzirom na to da nema specifičnog događaja u vašoj trgovini ili iz aplikacije koji bi pokrenuo tijek rada, podaci se ne uključuju automatski.

API referenca