సబ్‌స్క్రిప్షన్ కాంట్రాక్ట్ డేటాను పొందండి

సబ్‌స్క్రిప్షన్ కాంట్రాక్ట్ డేటాను ఉపయోగించే వర్క్‌ఫ్లోలలో, మీరు మీ స్టోర్ నుండి సబ్‌స్క్రిప్షన్ కాంట్రాక్ట్ సమాచారాన్ని తిరిగి పొందడానికి సబ్‌స్క్రిప్షన్ కాంట్రాక్ట్ డేటాను పొందండి చర్యను ఉపయోగించవచ్చు.

ఈ పేజీలో

కాన్ఫిగరేషన్

ఫీల్డ్‌లు

సబ్‌స్క్రిప్షన్ కాంట్రాక్ట్ డేటాను పొందండి చర్య కింది ఫీల్డ్‌లను కలిగి ఉంటుంది, ఇవి క్వెరీని రూపొందించడానికి ఉపయోగించబడతాయి:

డేటాను పొందండి చర్యలలో ఉపయోగించే ఫీల్డ్‌లు.
ఫీల్డ్	వివరణ
డేటాను దీని ద్వారా క్రమబద్ధీకరించండి	తప్పనిసరి. శోధన ప్రశ్న ద్వారా రిటర్న్ చేయబడిన డేటాను క్రమబద్ధీకరించే పారామితులు.
గరిష్ట ఫలితాల సంఖ్య	తప్పనిసరి. మీరు ఎంచుకున్న శోధన ప్రశ్న ద్వారా రిటర్న్ చేయగల గరిష్ట ఫలితాల సంఖ్య. మీరు ఒకేసారి 100 వరకు ఫలితాలను రిటర్న్ చేయవచ్చు.
క్వెరీ	తప్పనిసరి. సాధారణ క్వెరీల నుండి ఎంచుకోండి లేదా మీ స్వంతంగా సృష్టించుకోవడానికి అడ్వాన్స్‌డ్ (Advanced) ఎంచుకోండి.

క్వెరీ స్ట్రింగ్

ACTIVE స్టేటస్‌ను కలిగి ఉన్న సబ్‌స్క్రిప్షన్ కాంట్రాక్ట్‌లను పొందే క్వెరీకి ఇది ఒక ఉదాహరణ:

status: ACTIVE

status వేరియబుల్ అనేది సబ్‌స్క్రిప్షన్ కాంట్రాక్ట్‌ల క్వెరీలో అందుబాటులో ఉన్న ఒక ఫిల్టర్, దీన్ని అనేకసార్లు ఉపయోగించవచ్చు.

డేటాను క్వెరీ చేస్తున్నప్పుడు, ఈ కింది విషయాలు తెలుసుకోవడం సహాయకరంగా ఉంటుంది:

అందుబాటులో ఉన్న ఫిల్టర్‌ల జాబితా
క్వెరీలు తప్పనిసరిగా ఒక నిర్దిష్ట సింటాక్స్‌ను అనుసరించాలి
క్వెరీ ఫీల్డ్ విలువలు ఎల్లప్పుడూ డాక్యుమెంట్ చేయబడవు. కొన్ని సందర్భాల్లో, API డాక్యుమెంట్‌లను చూడటం ద్వారా ఈ విలువలని కనుగొనవచ్చు. ప్రత్యామ్నాయంగా, మీరు ఫిల్టర్ చేసినప్పుడు అడ్మిన్‌లోని URLలలో కూడా ఈ ఫీల్డ్ విలువలని కనుగొనవచ్చు. ఉదాహరణకు, కొన్ని ఆర్డర్ క్వెరీ విలువలని కనుగొనడానికి, అడ్మిన్‌లోని ఆర్డర్‌ల పేజీని ఫిల్టర్ చేసి, ఆపై URLని చెక్ చేయండి.
మీరు Shopify GraphiQL యాప్ను ఉపయోగించడం ద్వారా మీ షాపులో క్వెరీని రన్ చేయవచ్చు లేదా పరీక్షించవచ్చు.
మీ క్వెరీ విఫలమైతే ఏమి జరుగుతుందో గమనించండి. తరచుగా API (ఏదీ లేకుండా కాకుండా) అన్ని ఫలితాలను రిటర్న్ చేస్తుంది.

రిటర్న్ చేయబడిన డేటా

అన్ని డేటాను పొందండి చర్యలు 0 నుండి 100 రిసోర్స్‌లలో దేనినైనా ఒక జాబితాగా రిటర్న్ చేస్తాయి. మీ అవసరాన్ని బట్టి, మీరు ఈ డేటాను వివిధ రకాలుగా ఉపయోగించాలనుకోవచ్చు:

ప్రతిదానికీ ఒక ట్యాగ్ జోడించడం లాంటి వాటికోసం మీరు ప్రతి జాబితా ఐటెమ్‌ను విడిగా హ్యాండిల్ చేయాల్సి ఉంటే, అప్పుడు మీరు ఫర్ ఈచ్ చర్యను ఉపయోగించవచ్చు.
ఎన్ని ఫలితాలు రిటర్న్ చేయబడ్డాయి అని లెక్కించడం లాంటి వాటికోసం మీకు డేటాను ఏకీకృతం చేయాల్సిన అవసరం ఉంటే, అప్పుడు మీరు కౌంట్ లేదా సమ్ చర్యలను ఉపయోగించవచ్చు.
అన్ని ఐటెమ్‌లతో కూడిన ఇమెయిల్ పంపడం లాంటి వాటికోసం ఆ జాబితాను అవుట్‌పుట్ చేయాల్సి ఉంటే, అప్పుడు మీరు రిటర్న్ చేయబడిన డేటాను నేరుగా తదుపరి చర్యలలో ఉపయోగించవచ్చు.

ఈ చర్య తర్వాత వచ్చే దశల్లో రిటర్న్ చేయబడిన డేటాను యాక్సెస్ చేయడానికి, సబ్‌స్క్రిప్షన్ కాంట్రాక్ట్ డేటాను పొందండి అనే పేరు గల వేరియబుల్‌ను ఉపయోగించండి, ఇది సబ్‌స్క్రిప్షన్ కాంట్రాక్ట్‌ల జాబితా. మీరు ఈ వేరియబుల్‌ను షరతులు మరియు చర్యలలో రెంటిలోనూ ఉపయోగించవచ్చు. ఉదాహరణకు, మీరు అంతర్గత ఇమెయిల్‌ను పంపండి (Send internal email) చర్యలో ఆర్డర్‌ల జాబితాను ఈ విధంగా పంపవచ్చు:

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

గమనిక

ఒకే వర్క్‌ఫ్లోలో డేటాను పొందండి (Get data) చర్యను పలుమార్లు ఉపయోగిస్తే, అప్పుడు ఆ వేరియబుల్ పేరుకు ఒక సంఖ్య జోడించబడుతుంది. ఉదాహరణకు, ఆర్డర్ డేటాను పొందండి (Get order data) చర్యను రెండుసార్లు ఉపయోగించే వర్క్‌ఫ్లోలో, రిటర్న్ చేయబడిన డేటా కోసం మొదటి వేరియబుల్ getOrderData అలాగే రెండవ వేరియబుల్ getOrderData1 అవుతుంది. ఈ పేరును అనుకూలీకరించలేము.

ట్రిగ్గర్‌లు

మీరు షెడ్యూల్ చేసిన సమయం (Scheduled time) ట్రిగ్గర్‌తో సహా ఏదైనా వర్క్‌ఫ్లోలో ఈ చర్యను ఉపయోగించవచ్చు. షెడ్యూల్ చేసిన సమయం ట్రిగ్గర్‌ను ఉపయోగించే వర్క్‌ఫ్లోలో, ఈవెంట్ ఫలితంగా కాకుండా, మీరు పేర్కొన్న సమయానికి వర్క్‌ఫ్లో ప్రారంభమవుతుంది. మీ స్టోర్‌లో లేదా వర్క్‌ఫ్లోను ప్రారంభించే యాప్ నుండి ఎటువంటి నిర్దిష్ట ఈవెంట్ లేనందున, ఏ డేటానూ ఆటోమేటిక్‌గా చేర్చబడదు.