Dohvati podatke o članku
U tijekovima rada za koje su potrebni podaci za članak na blogu, možete upotrijebiti radnju Dohvati podatke o članku da biste dohvatili informacije o članku iz svoje trgovine Shopify.
Na ovoj stranici
Konfiguracija
Polja
Radnja Dohvati podatke o članku sadrži sljedeća polja:
| Polje | Opis |
|---|---|
| Razvrstaj podatke prema | Obavezno. Parametri prema kojima se razvrstavaju podaci vraćeni upitom za pretraživanje. |
| Maksimalan broj rezultata | Obavezno. Maksimalan broj rezultata koje odabrani upit za pretraživanje može vratiti. Moguće je vratiti najviše 100 odjednom. |
| Upit | Obavezno. Odaberite jedan od uobičajenih upita ili odaberite Napredno kako biste izradili vlastiti. |
Niz upita
Ovo je primjer upita za dohvaćanje članaka objavljenih tijekom proteklog dana:
published_at:<='{{ scheduledAt }}' AND published_at:>'{{ scheduledAt | date_minus: "1 day" }}'Varijabla published_at jest filtar dostupan za Upit o člancima i može se upotrijebiti više puta ili u kombinaciji s drugim varijablama. Varijabla Liquid scheduledAt dostupna je za tijekove rada koji se koriste pokretačem Zakazano vrijeme. Oznaka Liquid date_minus posebna je oznaka za aplikaciju Flow kojom se omogućuje oduzimanje vremena od datuma.
Prilikom postavljanja upita o podacima korisno je znati sljedeće:
Upiti se moraju pridržavati određene sintakse
Vrijednosti polja upita nisu uvijek dokumentirane. U nekim se slučajevima te vrijednosti mogu pronaći pregledom dokumentacije za API. S druge strane, tijekom filtriranja vrijednosti polja često možete pronaći i u URL-ovima na administratorskoj ploči. Na primjer, kako biste pronašli neke vrijednosti upita za narudžbe, filtrirajte stranicu Narudžbe na administratorskoj ploči, a zatim provjerite URL.
U svojoj trgovini možete pokrenuti ili testirati upit upotrebom 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 s bilo kojim brojem resursa od 0 do 100. Ovisno o vašem slučaju upotrebe, ove ćete podatke možda htjeti upotrijebiti na različite načine:
- Ako svakom stavkom na popisu morate rukovati pojedinačno, primjerice kako biste svakoj dodali oznaku, onda možete upotrijebiti radnju Za svaku.
- Ako morate prikupiti podatke, na primjer prebrojiti koliko je rezultata vraćeno, možete upotrijebiti radnju Broji ili Zbroji.
- Ako popis morate izvesti, na primjer poslati e-poruku sa svim stavkama, vraćene podatke možete upotrijebiti izravno u kasnijim radnjama.
Kako biste pristupili vraćenim podacima u koracima koji slijede nakon ove radnje, upotrijebite varijablu Dohvati podatke o članku, koja sadržava popis članaka. Ovu varijablu možete upotrijebiti u uvjetima i u radnjama. Na primjer, popis članaka možete poslati u radnji Pošalji internu e-poruku slično ovomu:
{% for single_article in GetArticleData %}
* {{ single_article.title }}
{% 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 događaja. Budući da u vašoj trgovini ili iz aplikacije ne postoji specifičan događaj koji pokreće tijek rada, podaci nisu automatski uključeni.
Referenca za API
Za više informacija o API-ju koji se upotrebljava u ovoj radnji pogledajte Articles query.