Dohvati podatke o stranici
U tijekovima rada koji zahtijevaju podatke o stranici, možete upotrijebiti radnju Get page data za dohvaćanje informacija o stranici iz vaše trgovine. Stranice su mrežne stranice u vašoj internetskoj trgovini koje sadrže informacije koje se rijetko mijenjaju, poput stranice O nama ili stranice za kontakt.
Na ovoj stranici
Konfiguracija
Polja
Radnja Get page data sadrži sljedeća polja:
| Polje | Opis |
|---|---|
| Poredaj podatke prema | Obavezno. Parametri prema kojima se sortiraju podaci koje je vratio upit za pretraživanje. |
| Maksimalni broj rezultata | Obavezno. Maksimalni broj rezultata koje može vratiti odabrani upit za pretraživanje. Moguće je vratiti najviše 100 rezultata odjednom. |
| Upit | Obavezno. Odaberite iz uobičajenih upita ili odaberite Advanced da biste izradili vlastiti. |
Niz upita
Ovo je primjer upita za dohvaćanje objavljenih stranica:
published_status:publishedVarijabla published_status filtar je dostupan u Pages query i može se upotrijebiti više puta ili u kombinaciji s drugim varijablama.
Prilikom postavljanja upita korisno je znati sljedeće:
Upiti moraju slijediti određenu sintaksu
Vrijednosti polja upita nisu uvijek dokumentirane. U nekim se slučajevima te vrijednosti mogu pronaći u dokumentaciji za API. Alternativno, vrijednosti polja često možete pronaći u URL-ovima na administratorskoj ploči pri filtriranju. Na primjer, da biste pronašli neke vrijednosti upita za narudžbu, filtrirajte stranicu Narudžbe na administratorskoj ploči, a zatim provjerite URL.
Upit možete pokrenuti ili testirati u svojoj trgovini pomoću aplikacije Shopify GraphiQL.
Imajte na umu što se događa ako vaš upit ne uspije. Često će API vratiti sve rezultate (umjesto nula).
Vraćeni podaci
Sve radnje Get data vraćaju popis od 0 do 100 resursa. Ovisno o vašem slučaju upotrebe, te podatke možete upotrijebiti na različite načine:
- Ako trebate obraditi svaku stavku na popisu pojedinačno, na primjer dodati oznaku za svaku od njih, možete upotrijebiti radnju For each.
- Ako trebate zbrojiti podatke, na primjer prebrojiti koliko je rezultata vraćeno, možete upotrijebiti radnju Count ili Sum.
- Ako trebate izvesti popis, na primjer poslati e-poruku sa svim stavkama, vraćene podatke možete upotrijebiti izravno u sljedećim radnjama.
Da biste pristupili vraćenim podacima u koracima koji slijede nakon ove radnje, upotrijebite varijablu naziva Get page data, koja predstavlja popis stranica. Ovu varijablu možete upotrijebiti u uvjetima i radnjama. Na primjer, popis stranica možete poslati u radnji Send internal email sličnoj ovoj:
{% for single_page in getPageData %}
* {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}Pokretači
Ovu radnju možete upotrijebiti u bilo kojem tijeku rada, uključujući pokretač Scheduled time. U tijeku rada koji upotrebljava pokretač Scheduled time, tijek rada započinje u vrijeme koje ste odredili, a ne kao rezultat nekog događaja. Budući da nema određenog događaja u vašoj trgovini ili iz aplikacije koji bi pokrenuo tijek rada, podaci se ne uključuju automatski.
Referenca na API
Za više informacija o API-ju koji se upotrebljava u ovoj radnji, pogledajte Pages query.