Eskuratu orriaren datuak
Orriaren datuak behar dituzten lan-fluxuetan, Eskuratu orriaren datuak ekintza erabil dezakezu dendako orriaren informazioa berreskuratzeko. Orriak zure sareko dendako web-orriak dira, eta gutxitan aldatzen den informazioa dute; esaterako, "Guri buruz" edo "Kontaktua" orriek.
Konfigurazioa
Eremuak
Eskuratu orriaren datuak ekintzak eremu hauek ditu:
| Eremua | Deskribapena |
|---|---|
| Ordenatu datuak honen arabera | Nahitaezkoa. Bilaketa-kontsultak itzulitako datuak ordenatzeko parametroak. |
| Emaitzen gehieneko kopurua | Nahitaezkoa. Hautatzen duzun bilaketa-kontsultak itzul dezakeen emaitzen gehieneko kopurua. Aldiko 100 itzul daitezke gehienez. |
| Kontsulta | Nahitaezkoa. Aukeratu kontsulta arrunten artean, edo hautatu Aurreratua zurea sortzeko. |
Kontsulta-katea
Hona hemen argitaratutako orriak eskuratzeko kontsulta baten adibidea:
published_status:publishedpublished_status aldagaia Orrien kontsultan erabilgarri dagoen iragazki bat da, eta hainbat aldiz erabil daiteke edo beste aldagai batzuekin konbina daiteke.
Datuak kontsultatzean, lagungarria da hau jakitea:
Kontsultak sintaxi jakin bat jarraitu behar du
Kontsulta-eremuen balioak ez daude beti dokumentatuta. Batzuetan, balio horiek aurkitzeko, APIaren dokumentazioa begiratu daiteke. Bestela, sarritan eremuen balioak administrazio-paneleko URLetan aurki ditzakezu iragaztean. Esaterako, eskaera-kontsulten balio batzuk aurkitzeko, iragazi administrazio-paneleko Eskaerak orria, eta begiratu URLa.
Kontsulta bat exekutatu edo probatu dezakezu zure dendan Shopify GraphiQL aplikazioa erabiliz.
Kontuan izan zer gertatzen den kontsultak huts egiten badu. Askotan, APIak emaitza guztiak itzuliko ditu (bat ere ez itzuli beharrean).
Itzulitako datuak
Eskuratu datuak ekintza guztiek 0 eta 100 baliabide bitarteko zerrenda itzultzen dute. Zure erabilera-kasuaren arabera, datu horiek hainbat modutan erabil ditzakezu:
- Zerrendako elementu bakoitza banan-banan kudeatu behar baduzu (adibidez, bakoitzari etiketa bat gehitzeko), For each ekintza erabil dezakezu.
- Datuak agregatu behar badituzu (adibidez, zenbat emaitza itzuli diren zenbatzeko), Zenbatu edo Batu ekintzak erabil ditzakezu.
- Zerrenda atera behar baduzu (adibidez, elementu guztiekin mezu elektroniko bat bidaltzeko), itzulitako datuak zuzenean erabil ditzakezu ondorengo ekintzetan.
Ekintza honen ondorengo urratsetan itzulitako datuak atzitzeko, erabili Eskuratu orriaren datuak izeneko aldagaia (orrien zerrenda bat da). Aldagai hori baldintzetan zein ekintzetan erabil dezakezu. Adibidez, orrien zerrenda Bidali barneko mezu elektronikoa ekintza batean bidal dezakezu, honen antzera:
{% for single_page in getPageData %}
* {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}Abiarazleak
Edozein lan-fluxutan erabil dezakezu ekintza hau, baita Programatutako ordua abiarazlean ere. Programatutako ordua abiarazlea erabiltzen duen lan-fluxu batean, lan-fluxua zuk zehaztutako orduan hasiko da, gertaera baten ondorioz hasi beharrean. Ez dagoenez lan-fluxua abiarazten duen gertaera espezifikorik zure dendan edo aplikazio batean, ez da daturik sartuko automatikoki.
APIaren erreferentzia
Ekintza honetan erabilitako APIari buruzko informazio gehiago lortzeko, ikusi Orrien kontsulta.