Hangi asukoha andmed

Töövoogudes, mis vajavad asukohaandmeid, saad asukohateabe hankimiseks oma Shopify poest kasutada toimingut Get location data. Asukohad on mis tahes kohad, kus sa hoiad laoseisu, müüd tooteid või lähetad või täidad tellimusi.

Sellel lehel

Konfiguratsioon

Väljad

Toiming Get location data sisaldab järgmisi välju.

Toimingutes Get data kasutatavad väljad.
Väli	Kirjeldus
Andmete sortimisalus	Nõutav. Parameetrid, mille järgi otsingupäringu tagastatud andmeid sorditakse.
Maksimaalne tulemuste arv	Nõutav. Sinu valitud otsingupäringu tagastatavate tulemuste maksimaalne arv. Korraga saab tagastada kuni 100 tulemust.
Päring	Nõutav. Vali levinud päringute seast või vali Täpsem, et luua oma päring.

Päringusõne

See on näidispäring asukohtade hankimiseks, kus on lubatud poest kättesaamine:

pickup_in_store:enabled

Muutuja pickup_in_store on filter, mis on saadaval jaotises Locations query, ning seda saab kasutada mitu korda või kombineerida teiste muutujatega.

Andmete päringul on kasulik teada järgmist:

Saadaolevate asukohafiltrite loend
Päringud peavad järgima kindlat süntaksit
Päringu väljaväärtused ei ole alati dokumenteeritud. Mõnel juhul leiab väärtused, vaadates API dokumentatsiooni. Teise võimalusena leiad väljaväärtused sageli admini URL-idest, kui kasutad filtreerimist. Näiteks mõne tellimuse päringu väärtuse leidmiseks filtreeri adminis lehte Tellimused ja seejärel kontrolli URL-i.
Saad oma poes päringut käivitada või testida, kasutades rakendust Shopify GraphiQL app.
Pane tähele, mis juhtub, kui sinu päring nurjub. Sageli tagastab API (mitte ühegi asemel) kõik tulemused.

Tagastatud andmed

Kõik toimingud Get data tagastavad loendi, milles on 0 kuni 100 ressurssi. Olenevalt kasutusjuhust võid soovida neid andmeid erinevatel viisidel kasutada:

Kui sul on vaja käsitleda iga loendi üksust eraldi, näiteks lisada igaühele silt, saad kasutada toimingut For each.
Kui sul on vaja andmeid koondada, näiteks lugeda kokku tagastatud tulemuste arv, saad kasutada toiminguid Count või Sum.
Kui sul on vaja loend väljastada, näiteks saata e-kiri kõigi üksustega, saad tagastatud andmeid kasutada otse järgnevates toimingutes.

Sellele toimingule järgnevates sammudes tagastatud andmetele juurdepääsemiseks kasuta muutujat Get location data, mis on asukohtade loend. Seda muutujat saad kasutada nii tingimustes kui ka toimingutes. Näiteks saad saata asukohtade loendi toimingus Send internal email sarnaselt järgnevaga:

{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}

Käivitajad

Seda toimingut saad kasutada igas töövoos, sealhulgas käivitajaga Scheduled time. Töövoos, mis kasutab käivitajat Scheduled time, algab töövoog sinu määratud ajal, mitte sündmuse tulemusel. Kuna poes või rakenduses puudub konkreetne sündmus, mis töövoo käivitaks, ei kaasata andmeid automaatselt.

API viide

Lisateavet selles toimingus kasutatava API kohta leiad jaotisest Locations query.