Pomoć
Prijavi se

Dohvaćanje podataka kolekcije

U tijekovima rada koji zahtijevaju podatke o kolekciji možete upotrijebiti radnju Get collection data za dohvaćanje informacija o kolekciji iz vaše trgovine.

Na ovoj stranici

Konfiguracija

Polja

Radnja Dohvaćanje podataka o kolekciji sadrži sljedeća polja.

Polja koja se upotrebljavaju u radnjama dohvaćanja podataka.
PoljeOpis
Poredaj podatke premaObavezno. Parametri prema kojima se sortiraju podaci vraćeni upitom za pretraživanje.
Maksimalan broj rezultataObavezno. Maksimalan broj rezultata koji može biti vraćen odabranim upitom za pretraživanje. Može se vratiti najviše 100 odjednom.
UpitObavezno. Odaberite iz uobičajenih upita ili odaberite Napredno za izradu vlastitog.

Niz upita

Ovo je primjer upita za dohvaćanje kolekcija koje su ažurirane u posljednjem danu:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Varijabla updated_at filter je dostupan u upitu za kolekcije te se može upotrijebiti više puta ili kombinirati s drugim varijablama. Varijabla Liquid scheduledAt dostupna je u tijekovima rada koji upotrebljavaju pokretač zakazanog vremena. Oznaka Liquid date_minus posebna je oznaka Flow koja vam omogućuje oduzimanje vremena od datuma.

Pri postavljanju upita za podatke dobro je znati sljedeće:

  • Popis dostupnih filtera kolekcije
  • Vrijednosti polja upita nisu uvijek dokumentirane. U nekim slučajevima te se vrijednosti mogu pronaći pregledom dokumentacije API-ja. Također, vrijednosti polja često se mogu pronaći u URL-ovima u administratorskoj ploči prilikom filtriranja. Na primjer, kako biste pronašli neke vrijednosti upita za narudžbe, filtrirajte stranicu Narudžbe u administratorskoj ploči i zatim provjerite URL.
  • Upit u svojoj trgovini možete pokrenuti ili testirati pomoću aplikacije Shopify GraphiQL.
  • Imajte na umu što se događa ako vaš upit ne uspije. Često će API vratiti sve rezultate (umjesto ni jednoga).

Vraćeni podaci

Sve radnje Dohvaćanje podataka vraćaju popis od 0 do 100 resursa. Ovisno o slučaju upotrebe, ove podatke možete upotrebljavati na različite načine:

  • Ako svaku stavku popisa trebate obraditi pojedinačno, primjerice dodati oznaku svakoj od njih, tada možete upotrijebiti radnju Za svaku.
  • Ako trebate agregirati podatke, poput prebrojavanja vraćenih rezultata, tada možete upotrijebiti radnje Prebrojavanje ili Zbroj.
  • Ako trebate ispisati popis, primjerice poslati e-poruku sa svim stavkama, vraćene podatke možete izravno upotrijebiti u narednim radnjama.

Da biste pristupili vraćenim podacima u koracima koji slijede ovu radnju, upotrijebite varijablu Dohvaćanje podataka o kolekciji, što je popis kolekcija. Ovu varijablu možete upotrijebiti i u uvjetima i u radnjama. Na primjer, popis kolekcija možete poslati u radnji Slanje interne e-poruke na sljedeći način:

{% for single_collection in GetCollectionData %}
* {{ single_collection.title }}
{% endfor %}

Pokretači

Ovu radnju možete upotrijebiti u svakom 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 nekog događaja. Budući da nema specifičnog događaja u vašoj trgovini ili iz aplikacije koji započinje tijek rada, nema automatski uključenih podataka.

Referenca API-ja