Shopify Flow आणि GraphQL Admin API

Shopify अ‍ॅडमिनचा विस्तार करणारी आणि ती वाढवणारी ऑटोमेशन्स आणि इंटिग्रेशन्स बिल्ड करण्यासाठी Flow हे Shopify GraphQL Admin API वापरते. वर्कफ्लोजमधील अटी आणि व्हेरिएबल्स चे मूल्यांकन करण्यासाठी तसेच तुमच्या Shopify स्टोअरमध्ये अ‍ॅक्शन्स घेण्यासाठी Flow हे API ची आवृत्ती 2026-01 वापरते. Flow हे API ला कॉल करून स्टोअर डेटा अ‍ॅक्सेस करत असल्यामुळे, तुम्हाला Flow मधून API मधील उपलब्ध असलेल्या जवळपास सर्व फील्ड्सचा अ‍ॅक्सेस मिळतो.

Shopify दर 3 महिन्यांनी नवीन API आवृत्त्या रिलीज करत असल्याने, जेव्हा फील्ड्स बदलले जातात किंवा डेप्रिकेट होतात तेव्हा काही वर्कफ्लोज अपडेट करणे आवश्यक असू शकते.

वर्कफ्लोजमध्ये GraphQL Admin API वापरणे

तुमच्या Shopify स्टोअरमध्ये बदल करण्यासाठी Flow मधील बहुतांश कृती या GraphQL Admin API वापरतात. उदाहरणार्थ, Add order tags कृती ही tagsAdd म्युटेशन वापरते. Send Admin API request कृती अनेक म्युटेशन्स वापरू शकते, ज्यामध्ये अद्याप Flow मध्ये कृती म्हणून उपलब्ध नसलेल्या म्युटेशन्सचाही समावेश आहे.

तुम्ही वर्कफ्लो तयार करत असताना, तुम्हाला वारंवार GraphQL Admin API सिंटॅक्सवर आधारित फील्डची नावे आणि वर्णने आढळतील. उदाहरणार्थ, वर्कफ्लोमध्ये व्हेरिएंटचे एकूण विक्रीयोग्य प्रमाण ठरवण्यासाठी, तुम्ही variants_item.inventoryQuantity व्हेरिएबल वापराल. दुसरे उदाहरण म्हणजे, ग्राहकाने तुमच्या ईमेल न्यूजलेटरची सदस्यता कोणत्या ठिकाणी घेतली हे ठरवण्यासाठी, तुम्ही emailSubscriptionMethod व्हेरिएबल वापराल.

Flow अ‍ॅपसोबत वर्कफ्लो तयार करण्यासाठी तुम्हाला API मध्ये पारंगत असण्याची आवश्यकता नाही, परंतु व्हेरिएबलची नावे आणि त्यांच्या व्याख्यांबद्दल थोडी माहिती असल्यास तुम्हाला हवे असलेले विशिष्ट वर्कफ्लो लॉजिक तयार करण्यात मदत होऊ शकते. उदाहरणार्थ, ग्राहकाच्या displayName आणि त्यांच्या firstName मधील फरक समजल्यास, तुम्हाला त्याचा कसा वापर करायचा आहे यावर अवलंबून योग्य डेटा अ‍ॅक्सेस करण्यासाठी तुमच्या वर्कफ्लोला मदत होऊ शकते. तुम्ही तुमचा वर्कफ्लो तयार करत असताना प्रत्येक व्हेरिएबलसोबत व्याख्या समाविष्ट केलेल्या असतात आणि कोणत्याही व्हेरिएबल किंवा व्याख्येबद्दल अधिक जाणून घेण्यासाठी तुम्ही वर क्लिक करू शकता.

स्टोअर डेटा आणि GraphQL Admin API

वर्कफ्लो अटी आणि कृतींमध्ये तुमच्या स्टोअरमधील डेटा वापरतात. Flow हे GraphQL Admin API चा वापर करून स्टोअरच्या डेटाचा अ‍ॅक्सेस मिळवते, याचा अर्थ तुम्हाला API मधील जवळपास सर्व फील्डचा अ‍ॅक्सेस मिळतो. एखाद्या कृतीकडे ट्रिगर किंवा Get data कृती द्वारे दिलेला आवश्यक डेटा नसल्यास, वर्कफ्लो चालत नाही आणि एरर मेसेज दाखवला जातो.

उदाहरणार्थ, वर्कफ्लो Customer created ट्रिगरने सुरू होतो आणि ग्राहक डेटा वर्कफ्लोमध्ये इंपोर्ट करतो. त्या ट्रिगरनंतर Add order tags कृती आल्यास, ज्यासाठी ग्राहक डेटा नाही तर ऑर्डर डेटा आवश्यक असतो, तर वर्कफ्लोमध्ये गहाळ डेटाचा एरर येईल.

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 चे मूल्यांकन कसे केले जाते यावर त्याचा संभाव्य परिणाम होतो.
• जेव्हा फील्ड्स नलेबल (nullable) बनतात, तेव्हा अटींचे किंवा Liquid चे मूल्यांकन कसे केले जाते यावर संभाव्य परिणाम होतो.
• जेव्हा एनम (enum) मूल्ये बदलतात किंवा नवीन युनियन किंवा इंटरफेस प्रकार जोडले जातात, तेव्हा Liquid किंवा कोडवर संभाव्य परिणाम होतो.
• जेव्हा म्युटेशन आर्ग्युमेंट्स बदलतात, तेव्हा Send Admin API request कृतींच्या कॉन्फिगरेशनवर संभाव्य परिणाम होतो.

काही वर्कफ्लो मॅन्युअली अपडेट करणे आवश्यक असू शकते. अशा प्रकरणांमध्ये, वर्कफ्लो Update required किंवा Unsupported API एरर दाखवू शकतात आणि वर्कफ्लो एडिटरमध्ये आवश्यक बदल करण्यासाठी तुम्हाला संबंधित API दस्तऐवजीकरण कडे मार्गदर्शन करू शकतात. जेव्हा हे अपडेट्स पूर्ण आणि सेव्ह केले जातात, तेव्हा वर्कफ्लो Flow मध्ये उपलब्ध असलेले नवीनतम API व्हर्जन वापरण्यासाठी स्वयंचलितपणे अपडेट होतो.

API व्हर्जन सुसंगतता एरर्स असलेल्या वर्कफ्लोमध्ये तातडीचे बदल करण्यासाठी तुम्ही तात्पुरते या समस्यांकडे दुर्लक्ष करणे निवडू शकता. जर या समस्यांचे निराकरण केले नाही, तर Shopify द्वारे जुन्या API व्हर्जनला यापुढे सपोर्ट दिला जाणार नाही तेव्हा वर्कफ्लो चालणे बंद होऊ शकते किंवा एरर्स येऊ शकतात.