Shopify Flow మరియు GraphQL Admin API

Shopify అడ్మిన్‌ను విస్తరించే మరియు మెరుగుపరిచే ఆటోమేషన్‌లు మరియు ఇంటిగ్రేషన్‌లను రూపొందించడానికి Flow Shopify GraphQL Admin APIని ఉపయోగిస్తుంది. వర్క్‌ఫ్లోలలో షరతులు మరియు వేరియబుల్స్‌ను మూల్యాంకనం చేయడానికి అలాగే మీ Shopify స్టోర్‌లో చర్యలు తీసుకోవడానికి Flow API యొక్క వెర్షన్ 2026-01ని ఉపయోగిస్తుంది. APIకి కాల్ చేయడం ద్వారా Flow స్టోర్ డేటాను యాక్సెస్ చేస్తుంది కాబట్టి, Flow నుండి APIలో అందుబాటులో ఉన్న దాదాపు అన్ని ఫీల్డ్‌లకు మీరు యాక్సెస్ కలిగి ఉంటారు.

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

వర్క్‌ఫ్లోలలో GraphQL Admin APIని ఉపయోగించడం

మీ Shopify స్టోర్‌లో మార్పులు చేయడానికి Flowలోని చాలా చర్యలు GraphQL Admin APIని ఉపయోగిస్తాయి. ఉదాహరణకు, ఆర్డర్ ట్యాగ్‌లను జోడించండి చర్య tagsAdd మ్యుటేషన్‌ను ఉపయోగిస్తుంది. Admin API అభ్యర్థనను పంపండి చర్య, Flowలో ఇంకా చర్యలుగా అందుబాటులో లేని వాటితో సహా చాలా మ్యుటేషన్‌లను ఉపయోగించగలదు.

మీరు వర్క్‌ఫ్లోలను సృష్టిస్తున్నప్పుడు, మీరు తరచుగా GraphQL Admin API సింటాక్స్ ఆధారిత ఫీల్డ్ పేర్లు, వివరణలను చూస్తారు. ఉదాహరణకు, వర్క్‌ఫ్లోలోని వేరియంట్‌కి చెందిన మొత్తం విక్రయించదగిన పరిమాణాన్ని నిర్ధారించడానికి, మీరు variants_item.inventoryQuantity వేరియబుల్‌ని ఉపయోగిస్తారు. మరో ఉదాహరణ, కస్టమర్ మీ ఇమెయిల్ న్యూస్‌లెటర్‌కు ఏ లొకేషన్‌లో సబ్‌స్క్రయిబ్ అయ్యారో నిర్ధారించడానికి, మీరు emailSubscriptionMethod వేరియబుల్‌ని ఉపయోగిస్తారు.

Flow యాప్‌తో వర్క్‌ఫ్లోలను సృష్టించడానికి మీరు APIలో ప్రావీణ్యం కలిగి ఉండాల్సిన అవసరం లేదు, కానీ వేరియబుల్ పేర్లు, వాటి నిర్వచనాల గురించి కొద్దిగా అర్థం చేసుకోవడం వలన మీకు కావలసిన నిర్దిష్ట వర్క్‌ఫ్లో లాజిక్‌ను నిర్మించడంలో సహాయపడుతుంది. ఉదాహరణకు, కస్టమర్‌కి సంబంధించిన displayName, వారి firstName మధ్య వ్యత్యాసం తెలుసుకోవడం వలన, మీరు దానిని దేని కోసం ఉపయోగించాలనుకుంటున్నారు అనేదానిపై ఆధారపడి, సరైన డేటాను యాక్సెస్ చేయడంలో మీ వర్క్‌ఫ్లోకి సహాయపడుతుంది. మీరు మీ వర్క్‌ఫ్లోను రూపొందించేటప్పుడు ప్రతి వేరియబుల్‌తో నిర్వచనాలు చేర్చబడతాయి, ఏదైనా వేరియబుల్ లేదా నిర్వచనం గురించి మరింత తెలుసుకోవడానికి మీరు ను క్లిక్ చేయవచ్చు.

స్టోర్ డేటా, GraphQL Admin API

వర్క్‌ఫ్లోలు షరతులు, చర్యలలో మీ స్టోర్ నుండి డేటాను ఉపయోగిస్తాయి. Flow, GraphQL Admin APIని ఉపయోగించి స్టోర్ డేటాను యాక్సెస్ చేస్తుంది, అంటే మీకు APIలోని దాదాపు అన్ని ఫీల్డ్‌లకు యాక్సెస్ ఉంటుంది. ట్రిగ్గర్ లేదా డేటాను పొందండి చర్య ద్వారా అందించబడిన అవసరమైన డేటా చర్యలో లేకుంటే, వర్క్‌ఫ్లో రన్ కాదు, ఎర్రర్ మెసేజ్ ప్రదర్శించబడుతుంది.

ఉదాహరణకు, వర్క్‌ఫ్లో కస్టమర్ సృష్టించబడ్డారు ట్రిగ్గర్‌తో మొదలవుతుంది, వర్క్‌ఫ్లోకి కస్టమర్ డేటాను దిగుమతి చేస్తుంది. ఆ ట్రిగ్గర్ తర్వాత, కస్టమర్ డేటా కాకుండా ఆర్డర్ డేటా అవసరమయ్యే ఆర్డర్ ట్యాగ్‌లను జోడించండి చర్య ఉంటే, ఆ వర్క్‌ఫ్లో మిస్ అయిన డేటా ఎర్రర్‌కి దారి తీస్తుంది.

API ద్వారా ఏవి అవుట్‌పుట్ చేయబడుతున్నాయో, Flowలో ఏవి ఉపయోగించబడుతున్నాయో అర్థం చేసుకోవడానికి, అలాగే మీ వర్క్‌ఫ్లో మీరు ఆశించిన డేటాను అవుట్‌పుట్ చేస్తుందని నిర్ధారించుకోవడానికి, మీరు డేటాను ప్రివ్యూ చేయాల్సి రావచ్చు లేదా API డాక్యుమెంటేషన్‌ను రివ్యూ చేయాల్సి రావచ్చు.

ఫీల్డ్ ఆర్గ్యుమెంట్‌లు, GraphQL Admin API

కొన్ని GraphQL Admin API ఫీల్డ్‌లకు, ఏ డేటా అందించబడుతుందో తగ్గించే అదనపు పారామితులైన ఆర్గ్యుమెంట్‌లు అవసరం. ఉదాహరణకు, ఏ కలెక్షన్‌ను తనిఖీ చేయాలో తెలుసుకోవడానికి product.inCollection ఫీల్డ్‌కు కలెక్షన్ id ఆర్గ్యుమెంట్ అవసరం. అది లేకుండా, ఫీల్డ్ ఫలితాన్ని అందించలేదు.

Flowలో, మీరు అవసరమైన ఆర్గ్యుమెంట్ విలువను అందించడం ద్వారా ఈ ఫీల్డ్‌ల నుండి వేరియబుల్‌లను సృష్టించవచ్చు, వీటిని తర్వాత వర్క్‌ఫ్లోలో ఉపయోగించవచ్చు. ఉదాహరణకు, product.inCollection(id: "gid://shopify/Collection/123456")కు product.inSummerBestsellersగా పేరు పెట్టడం వంటి, తదుపరి దశలలో సులభంగా రిఫరెన్స్ చేయడానికి మీరు వేరియబుల్‌కి కస్టమ్ పేరును కూడా కేటాయించవచ్చు.

ఆర్గ్యుమెంట్‌లతో కూడిన ఫీల్డ్‌ల నుండి వేరియబుల్స్‌ను సృష్టించడం గురించి మరింత తెలుసుకోండి.

మెటాఫీల్డ్‌ల నుండి వేరియబుల్స్‌ను సృష్టించడానికి Flowలో అదనపు సమాచారం అవసరం ఎందుకంటే ప్రతి మెటాఫీల్డ్ నేమ్‌స్పేస్, కీని మీరే స్వయంగా నిర్వచించుకుంటారు, కాబట్టి ఆర్గ్యుమెంట్‌లు ఎల్లప్పుడూ మీ స్టోర్‌కు ప్రత్యేకంగా ఉంటాయి. Flowలో మెటాఫీల్డ్‌ల గురించి మరింత తెలుసుకోండి.

API వెర్షనింగ్

Shopify ప్రతి 3 నెలలకోసారి కొత్త API వెర్షన్‌లను విడుదల చేస్తుంది, Flow వీలైనంత త్వరగా కొత్త వెర్షన్‌లను స్వీకరిస్తుంది, అయితే ఇది లేటెస్ట్ వెర్షన్ కంటే వెనుకబడి ఉండవచ్చు. వీలైనప్పుడు, వెర్షన్‌ల మధ్య మార్పులు ఆటోమేటిక్‌గా పరిష్కరించబడతాయి, అయితే కింది ఏవైనా పరిస్థితులతో సహా కొన్ని మార్పులు సులభంగా ఉండకపోవచ్చు:

• ఫీల్డ్‌లు తీసివేయబడినా ప్రత్యామ్నాయం ఏదీ అందించబడనప్పుడు, షరతులు లేదా Liquidను ఎలా మదింపు చేస్తారు అనేదానిపై ప్రభావం చూపే అవకాశం ఉంది.
• ఫీల్డ్‌లు శూన్యమైనప్పుడు, షరతులు లేదా Liquidను ఎలా మదింపు చేస్తారు అనేదానిపై ప్రభావం చూపే అవకాశం ఉంది.
• ఎనమ్ (enum) విలువలు మారినప్పుడు లేదా కొత్త యూనియన్ లేదా ఇంటర్‌ఫేస్ రకాలు జోడించబడినప్పుడు, Liquid లేదా కోడ్‌పై ప్రభావం చూపే అవకాశం ఉంది.
• మ్యుటేషన్ ఆర్గ్యుమెంట్‌లు మారినప్పుడు, Admin API అభ్యర్థనను పంపండి చర్యల కాన్ఫిగరేషన్‌పై ప్రభావం చూపే అవకాశం ఉంది.

కొన్ని వర్క్‌ఫ్లోలను మాన్యువల్‌గా అప్‌డేట్ చేయాల్సి రావచ్చు. ఈ సందర్భాలలో, వర్క్‌ఫ్లోలు అప్‌డేట్ అవసరం లేదా సపోర్ట్ లేని API ఎర్రర్‌ను ప్రదర్శించవచ్చు, అలాగే వర్క్‌ఫ్లో ఎడిటర్‌లో అవసరమైన మార్పులు చేయడానికి, సంబంధిత API డాక్యుమెంటేషన్‌కు మీకు మార్గనిర్దేశం చేస్తాయి. ఈ అప్‌డేట్‌లు పూర్తయి, సేవ్ చేయబడిన తర్వాత, వర్క్‌ఫ్లో ఆటోమేటిక్‌గా Flowలో అందుబాటులో ఉన్న లేటెస్ట్ API వెర్షన్‌ని ఉపయోగించడానికి అప్‌డేట్ అవుతుంది.

API వెర్షన్ కంపాటబిలిటీ ఎర్రర్‌లు ఉన్న వర్క్‌ఫ్లోలో అత్యవసర మార్పులు చేయడానికి మీరు సమస్యలను తాత్కాలికంగా విస్మరించడానికి ఎంచుకోవచ్చు. ఈ సమస్యలు పరిష్కరించబడకపోతే, పాత API వెర్షన్‌కు Shopify సపోర్ట్ ఇవ్వడం ఆపివేసినప్పుడు, వర్క్‌ఫ్లో రన్ అవ్వడం ఆగిపోవచ్చు లేదా ఎర్రర్‌లకు కారణం కావచ్చు.