Dohvati unose metaobjekta

Pomoću radnje Dohvati unose metaobjekta možete dohvatiti popis unosa za metaobjekt iz svoje trgovine na temelju neobaveznog upita. Za više informacija pogledajte dokumentaciju o metaobjektima.

Konfiguracija

Polja

Radnja Dohvati unose metaobjekta sadrži padajući izbornik za određivanje definicije metaobjekta te sljedeća polja koja se upotrebljavaju za izradu upita:

Niz upita

Ovo je primjer upita za dohvaćanje unosa metaobjekta ako vrijednost polja email odgovara e-adresi iz narudžbe:

{{fields.email}}:"{{order.email}}"

Ovo je primjer upita za dohvaćanje unosa metaobjekta ažuriranih tijekom proteklog dana:

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

Varijabla updated_at jest filtar dostupan u upitu za metaobjekte i može se upotrebljavati više puta ili u kombinaciji s drugim varijablama. Varijabla Liquid scheduledAt dostupna je u tijekovima rada koji upotrebljavaju pokretač Zakazano vrijeme. Oznaka Liquid date_minus posebna je oznaka aplikacije Flow koja vam omogućuje da oduzmete vrijeme od datuma.

Prilikom slanja upita za podatke korisno je znati sljedeće:

• Popis dostupnih filtara metaobjekta
• Slanje upita za metaobjekte prema vrijednosti polja zahtijeva da metaobjekt ima omogućeno filtriranje, što se može omogućiti u opcijama za prilagođene podatke u administratorskom alatu za Shopify.
• Upiti moraju slijediti određenu sintaksu
• Vrijednosti polja upita nisu uvijek dokumentirane. U nekim se slučajevima vrijednosti mogu pronaći u API dokumentaciji. Također, vrijednosti polja često možete pronaći u URL-ovima na administratorskoj ploči prilikom filtriranja. Na primjer, da biste pronašli neke vrijednosti upita za narudžbe, filtrirajte stranicu Narudžbe na administratorskoj ploči i zatim provjerite URL.
• Upit u svojoj trgovini možete pokrenuti ili testirati pomoću aplikacije Shopify GraphiQL.
• Obratite pozornost na to što se događa ako upit ne uspije. Često će API vratiti sve rezultate (umjesto nijednog).

Vraćeni podaci

Sve radnje Dohvati podatke vraćaju popis od 0 do 100 resursa. Ovisno o vašem slučaju upotrebe, te podatke možete upotrijebiti na razne načine:

• Ako trebate pojedinačno obraditi svaku stavku na popisu, primjerice dodati joj oznaku, možete upotrijebiti radnju Za svaki.
• Ako trebate agregirati podatke, na primjer prebrojiti koliko je rezultata vraćeno, možete upotrijebiti radnju Prebroji ili Zbroji.
• Ako popis trebate izvesti, na primjer poslati e-poruku sa svim stavkama, vraćene podatke možete upotrijebiti izravno u narednim radnjama.

Za pristup vraćenim podacima u koracima koji slijede nakon ove radnje upotrijebite varijablu pod nazivom Dohvati unose metaobjekta, koja predstavlja popis unosa metaobjekta. Ovu varijablu možete upotrijebiti i u uvjetima i u radnjama. Na primjer, popis parova ključeva i vrijednosti za unose metaobjekta u radnji Pošalji internu e-poruku možete poslati ovako:

{% for getMetaobjectEntries_item in getMetaobjectEntries %}
Key-value pairs for entry:
  {% for fields_item in getMetaobjectEntries_item.system.fields %}
    {{fields_item.key}}:{{fields_item.value}}
  {% endfor %}
{% endfor %}

Pokretači

Ovu radnju možete upotrijebiti u svakom tijeku rada, uključujući pokretač Zakazano vrijeme. U tijeku rada u kojem se upotrebljava pokretač Zakazano vrijeme tijek rada pokreće se u vrijeme koje ste odredili, a ne kao rezultat događaja. Budući da ne postoji specifičan događaj u trgovini ili aplikaciji koji započinje tijek rada, podaci se ne uključuju automatski.

Informacije o API-ju

• Resurs metaobjekta
• Filtri upita za metaobjekte
• Upiti za metaobjekte prema vrijednosti polja