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.

Konfiguracija

Polja

Radnja Get page data sadrži sljedeća polja:

Polja koja se upotrebljavaju u radnjama Get data.
PoljeOpis
Poredaj podatke premaObavezno. Parametri prema kojima se sortiraju podaci koje je vratio upit za pretraživanje.
Maksimalni broj rezultataObavezno. Maksimalni broj rezultata koje može vratiti odabrani upit za pretraživanje. Moguće je vratiti najviše 100 rezultata odjednom.
UpitObavezno. 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:published

Varijabla 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:

  • Popis dostupnih filtara za stranice

  • 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.