Dohvati podatke o lokaciji
U tijekovima rada koji zahtijevaju podatke o lokaciji možete upotrijebiti radnju Dohvati podatke o lokaciji za dohvaćanje informacija o lokaciji iz vaše trgovine Shopify. Lokacije su bilo koje mjesto na kojem čuvate zalihe, prodajete proizvode ili šaljete odnosno obrađujete narudžbe.
Na ovoj stranici
Konfiguracija
Polja
Radnja Dohvati podatke o lokaciji sadrži sljedeća polja.
| Polje | Opis |
|---|---|
| Sortiraj podatke prema | Obavezno. Parametri prema kojima se sortiraju podaci koje vraća upit za pretraživanje. |
| Maksimalan broj rezultata | Obavezno. Maksimalan broj rezultata koje može vratiti odabrani upit za pretraživanje. Odjednom možete vratiti do 100 rezultata. |
| Upit | Obavezno. Odaberite među uobičajenim upitima ili odaberite Napredno da biste izradili vlastiti upit. |
Niz upita
Ovo je primjer upita za dohvaćanje lokacija na kojima je omogućeno preuzimanje u trgovini:
pickup_in_store:enabledVarijabla pickup_in_store je filtar dostupan u sklopu upita o lokacijama te se može upotrijebiti više puta ili kombinirati s drugim varijablama.
Prilikom postavljanja upita o podacima korisno je znati sljedeće:
Upiti moraju slijediti određenu sintaksu
Vrijednosti polja upita nisu uvijek dokumentirane. U nekim se slučajevima vrijednosti mogu pronaći pregledom dokumentacije za API. Vrijednosti polja često možete pronaći i u URL-ovima na administratorskoj ploči prilikom filtriranja. Na primjer, da biste pronašli neke vrijednosti za upite o narudžbama, filtrirajte stranicu Narudžbe na administratorskoj ploči i zatim provjerite URL.
Upit možete pokrenuti ili testirati u svojoj trgovini s pomoću aplikacije Shopify GraphiQL.
Imajte na umu što se događa ako vaš upit ne uspije. Često će API 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 biste podatke mogli upotrijebiti na različite načine:
- Ako trebate pojedinačno obraditi svaku stavku s popisa, primjerice da biste svakoj dodali oznaku, možete upotrijebiti radnju Za svaki.
- Ako trebate prikupiti podatke, na primjer prebrojiti koliko je rezultata vraćeno, možete upotrijebiti radnje Prebroji ili Zbroji.
- Ako trebate ispisati popis, na primjer poslati e-poruku sa svim stavkama, vraćene podatke možete izravno upotrijebiti u narednim radnjama.
Za pristup vraćenim podacima u koracima koji slijede nakon ove radnje upotrijebite varijablu Dohvati podatke o lokaciji, što je popis lokacija. Tu varijablu možete upotrebljavati i u uvjetima i u radnjama. Na primjer, popis lokacija možete poslati u radnji Pošalji internu e-poruku ovako:
{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% 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. Budući da ne postoji određeni događaj u vašoj trgovini ili iz aplikacije koji pokreće tijek rada, podaci se ne uključuju automatski.
Referenca za API
Više informacija o API-ju koji se upotrebljava u ovoj radnji potražite u upitu o lokacijama.