Gauti prenumeratos sutarties duomenis

Darbo eigose, kuriose naudojami prenumeratos sutarčių duomenys, galite naudoti veiksmą Gauti prenumeratos sutarties duomenis, kad nuskaitytumėte prenumeratos sutarčių informaciją iš savo parduotuvės.

Šiame puslapyje

Konfigūracija

Laukai

Veiksmas Gauti prenumeratos sutarties duomenis apima toliau nurodytus laukus, kurie naudojami užklausai sukurti:

Laukai, naudojami veiksmuose „Gauti duomenis“.
Laukas	Aprašas
Rūšiuoti duomenis pagal	Būtina. Parametrai, pagal kuriuos rūšiuojami paieškos užklausos grąžinti duomenys.
Didžiausias rezultatų skaičius	Būtina. Didžiausias rezultatų, kuriuos gali grąžinti Jūsų pasirinkta paieškos užklausa, skaičius. Vienu metu galite grąžinti iki 100 rezultatų.
Užklausa	Būtina. Pasirinkite iš įprastų užklausų arba pasirinkite Išplėstinė, kad sukurtumėte savo.

Užklausos eilutė

Štai užklausos, skirtos gauti prenumeratos sutartis, kurių būsena yra ACTIVE, pavyzdys:

status: ACTIVE

Kintamasis status yra filtras, pasiekiamas Prenumeratos sutarčių užklausoje, ir gali būti naudojamas kelis kartus.

Teikiant duomenų užklausą naudinga žinoti:

Pasiekiamų filtrų sąrašas
Užklausos turi atitikti tam tikrą sintaksę
Užklausos laukų vertės ne visada yra dokumentuotos. Kai kuriais atvejais vertes galima rasti peržiūrėjus API dokumentus. Arba laukų vertes dažnai galite rasti administratoriaus skydelio URL, kai filtruojate. Pavyzdžiui, norėdami rasti kai kurias užsakymo užklausos vertes, filtruokite puslapį „Užsakymai“ administratoriaus skydelyje ir patikrinkite URL.
Užklausą savo parduotuvėje galite paleisti arba išbandyti naudodami „Shopify GraphiQL“ programėlę.
Atminkite, kas nutiks, jei jūsų užklausa nepavyks. Dažnai API grąžins visus rezultatus, o ne nė vieno.

Grąžinti duomenys

Visi veiksmai Gauti duomenis grąžina sąrašą nuo 0 iki 100 išteklių. Atsižvelgiant į Jūsų naudojimo atvejį, šiuos duomenis galite naudoti įvairiais būdais:

Jei kiekvieną sąrašo elementą reikia apdoroti atskirai, pavyzdžiui, prie kiekvieno pridėti žymą, galite naudoti veiksmą „Kiekvienam“.
Jei reikia apibendrinti duomenis, pavyzdžiui, suskaičiuoti, kiek rezultatų buvo grąžinta, galite naudoti veiksmus „Skaičiuoti“ arba „Sumuoti“.
Jei reikia pateikti sąrašą, pavyzdžiui, išsiųsti el. laišką su visais elementais, vėlesniuose veiksmuose galite tiesiogiai naudoti grąžintus duomenis.

Norėdami pasiekti grąžintus duomenis veiksmuose, kurie seka po šio, naudokite kintamąjį pavadinimu Gauti prenumeratos sutarties duomenis, kuris yra prenumeratos sutarčių sąrašas. Šį kintamąjį galite naudoti ir sąlygose, ir veiksmuose. Pavyzdžiui, užsakymų sąrašą galite išsiųsti veiksmu Siųsti vidinį el. laišką, štai taip:

{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.name }}
{% endfor %}

Paleidikliai

Šį veiksmą galite naudoti bet kurioje darbo eigoje, įskaitant paleidiklį Suplanuotas laikas. Darbo eigoje, kurioje naudojamas paleidiklis Suplanuotas laikas, darbo eiga pradedama Jūsų nurodytu laiku, o ne dėl kokio nors įvykio. Kadangi nėra jokio konkretaus įvykio Jūsų parduotuvėje ar programėlėje, kuris pradėtų darbo eigą, jokie duomenys automatiškai neįtraukiami.