Shopify Flow और GraphQL Admin API.

Flow, ऐसे ऑटोमेशन और इंटीग्रेशन बनाने के लिए Shopify GraphQL Admin API का उपयोग करता है जो Shopify एडमिन का विस्तार करते हैं और उसे बेहतर बनाते हैं। Flow, आपके Shopify स्टोर में कार्रवाई करने के साथ-साथ वर्कफ़्लो में शर्तों और वैरिएबल का मूल्यांकन करने के लिए API के 2026-01 वर्शन का उपयोग करता है। चूंकि Flow, API को कॉल करके स्टोर डेटा को एक्सेस करता है, इसलिए आपको Flow से API में उपलब्ध लगभग सभी फ़ील्ड का एक्सेस मिलता है।

चूंकि Shopify हर 3 महीने में नए API वर्शन रिलीज़ करता है, इसलिए फ़ील्ड बदले जाने या बंद किए जाने पर कुछ वर्कफ़्लो को अपडेट करने की ज़रूरत पड़ सकती है।

वर्कफ़्लो में GraphQL Admin API का उपयोग करना

Flow में ज़्यादातर कार्रवाई, आपके Shopify स्टोर में बदलाव करने के लिए 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 का मूल्यांकन कैसे किया जाता है।
• जब एनम मान बदलते हैं या नए यूनियन या इंटरफ़ेस प्रकार जोड़े जाते हैं, तो यह Liquid या कोड को प्रभावित कर सकता है।
• जब म्यूटेशन आर्ग्युमेंट बदलते हैं, तो यह 'Admin API अनुरोध भेजें' कार्रवाइयों के कॉन्फ़िगरेशन को प्रभावित कर सकता है।

कुछ वर्कफ़्लो को मैन्युअल रूप से अपडेट करने की ज़रूरत पड़ सकती है। इन मामलों में, वर्कफ़्लो में अपडेट ज़रूरी है या असमर्थित API गड़बड़ी दिखाई दे सकती है और यह आपको वर्कफ़्लो एडिटर में ज़रूरी बदलाव करने के लिए काम के API डॉक्यूमेंटेशन पर भेज सकता है। जब ये अपडेट पूरे हो जाते हैं और सेव कर लिए जाते हैं, तो वर्कफ़्लो, Flow में उपलब्ध सबसे नए API वर्शन का उपयोग करने के लिए अपने-आप अपडेट हो जाता है।

आप API वर्शन संगतता गड़बड़ियों वाले किसी वर्कफ़्लो में ज़रूरी बदलाव करने के लिए समस्याओं को कुछ समय के लिए अनदेखा करना चुन सकते हैं। अगर इन समस्याओं का समाधान नहीं किया जाता है, तो Shopify की ओर से पुराने API वर्शन का सपोर्ट बंद हो जाने पर वर्कफ़्लो चलना बंद हो सकता है या उसमें गड़बड़ियां हो सकती हैं।