कैटलॉग का डेटा प्राप्त करें
जिन वर्कफ़्लो को कैटलॉग के डेटा की आवश्यकता होती है, उनमें आप अपने स्टोर से B2B कैटलॉग की जानकारी वापस पाने के लिए Get catalog data एक्शन का उपयोग कर सकते हैं। कैटलॉग विशिष्ट B2B ग्राहकों या कंपनी की लोकेशन के लिए कस्टमाइज़ किए गए मूल्य निर्धारण वाले प्रोडक्ट के समूह होते हैं।
कॉन्फ़िगरेशन
फ़ील्ड
Get catalog data एक्शन में निम्नलिखित फ़ील्ड शामिल हैं:
| फ़ील्ड | जानकारी |
|---|---|
| डेटा को इसके आधार पर सॉर्ट करें | ज़रूरी है। वे पैरामीटर जिनके द्वारा खोज क्वेरी से लौटाए गए डेटा को सॉर्ट किया जाता है। |
| परिणामों की अधिकतम संख्या | आवश्यक है। आपके द्वारा चुनी गई सर्च क्वेरी से प्राप्त होने वाले परिणामों की अधिकतम संख्या। आप एक बार में 100 तक परिणाम प्राप्त कर सकते हैं। |
| क्वेरी | आवश्यक है। सामान्य क्वेरी में से चुनें या अपनी खुद की क्वेरी बनाने के लिए एडवांस्ड चुनें। |
क्वेरी स्ट्रिंग
सभी सक्रिय कैटलॉग प्राप्त करने के लिए यहां एक उदाहरण क्वेरी दी गई है:
status:ACTIVEstatus वेरिएबल, Catalogs query पर उपलब्ध एक फ़िल्टर है और इसका इस्तेमाल कई बार या अन्य वेरिएबल के साथ मिलाकर किया जा सकता है।
डेटा क्वेरी करते समय, यह जानना उपयोगी होता है:
क्वेरी को एक विशिष्ट सिंटैक्स का पालन करना चाहिए
क्वेरी फ़ील्ड वैल्यू हमेशा डॉक्यूमेंटेड नहीं होती हैं। कुछ मामलों में, API डॉक्स देखकर वैल्यू मिल सकती हैं। इसके अलावा, फ़िल्टर करते समय आप अक्सर एडमिन के URL में फ़ील्ड वैल्यू पा सकते हैं। उदाहरण के लिए, कुछ ऑर्डर क्वेरी वैल्यू खोजने के लिए, एडमिन में ऑर्डर पेज को फ़िल्टर करें और फिर URL देखें।
आप Shopify GraphiQL ऐप का उपयोग करके अपने शॉप में क्वेरी चला सकते हैं या टेस्ट कर सकते हैं।
ध्यान रखें कि यदि आपकी क्वेरी विफल हो जाती है, तो क्या होता है। अक्सर API (कुछ नहीं के बजाय) सभी परिणाम लौटाएगा।
लौटाया गया डेटा
सभी Get data कार्रवाइयां 0 से 100 रिसोर्स तक की सूची लौटाती हैं। आपके उपयोग के मामले के आधार पर, आप इस डेटा का अलग-अलग तरीकों से उपयोग कर सकते हैं:
- यदि आपको प्रत्येक सूची आइटम को व्यक्तिगत रूप से हैंडल करने की आवश्यकता है, जैसे कि प्रत्येक के लिए एक टैग जोड़ना, तो आप For each कार्रवाई का उपयोग कर सकते हैं।
- यदि आपको डेटा को एग्रीगेट करने की आवश्यकता है, जैसे यह गिनना कि कितने परिणाम वापस आए, तो आप Count या Sum कार्रवाइयों का उपयोग कर सकते हैं।
- यदि आपको सूची आउटपुट करने की आवश्यकता है, जैसे कि सभी आइटम के साथ ईमेल भेजना, तो आप सीधे बाद की कार्रवाइयों में लौटाए गए डेटा का उपयोग कर सकते हैं।
इस कार्रवाई के बाद आने वाले चरणों में लौटाए गए डेटा तक पहुंचने के लिए, Get catalog data नामक वेरिएबल का उपयोग करें, जो कैटलॉग की एक सूची है। आप इस वेरिएबल का उपयोग शर्तों और कार्रवाइयों दोनों में कर सकते हैं। उदाहरण के लिए, आप इस तरह की एक Send internal email कार्रवाई में कैटलॉग की सूची भेज सकते हैं:
{% for single_catalog in getCatalogData %}
* {{ single_catalog.title }}
{% endfor %}ट्रिगर
आप इस कार्रवाई का उपयोग किसी भी वर्कफ़्लो में कर सकते हैं, जिसमें Scheduled time ट्रिगर शामिल है। Scheduled time ट्रिगर का उपयोग करने वाले वर्कफ़्लो में, वर्कफ़्लो किसी ईवेंट के परिणामस्वरूप होने के बजाय आपके द्वारा निर्दिष्ट समय पर शुरू होता है। क्योंकि आपके स्टोर में या किसी ऐप से कोई विशिष्ट ईवेंट नहीं है जो वर्कफ़्लो शुरू करता है, इसलिए स्वचालित रूप से कोई डेटा शामिल नहीं होता है।
API संदर्भ
इस कार्रवाई में उपयोग किए गए API के बारे में अधिक जानकारी के लिए, Catalogs query देखें।