सब्सक्रिप्शन के लिए अनुबंध का डेटा पाएं
सब्सक्रिप्शन के लिए अनुबंध के डेटा का उपयोग करने वाले वर्कफ़्लो में, आप अपने स्टोर से सब्सक्रिप्शन के लिए अनुबंध की जानकारी वापस पाने के लिए सब्सक्रिप्शन के लिए अनुबंध का डेटा पाएं कार्रवाई का उपयोग कर सकते हैं।
कॉन्फ़िगरेशन
फ़ील्ड
सब्सक्रिप्शन के लिए अनुबंध का डेटा पाएं कार्रवाई में निम्नलिखित फ़ील्ड होते हैं, जिनका उपयोग क्वेरी बनाने के लिए किया जाता है:
| फ़ील्ड | विवरण |
|---|---|
| डेटा को इसके अनुसार क्रमित करें | ज़रूरी. वे पैरामीटर जिनके द्वारा खोज क्वेरी से लौटाया गया डेटा क्रमित किया जाता है. |
| परिणामों की अधिकतम संख्या | ज़रूरी. आपके द्वारा चुनी गई खोज क्वेरी से लौटाए जा सकने वाले परिणामों की अधिकतम संख्या. आप एक बार में 100 तक लौटा सकते हैं. |
| क्वेरी | ज़रूरी. सामान्य क्वेरी में से चुनें या अपनी खुद की बनाने के लिए उन्नत चुनें. |
क्वेरी स्ट्रिंग
यह ACTIVE स्टेटस वाले सब्सक्रिप्शन के लिए अनुबंध पाने के लिए एक उदाहरण क्वेरी है:
status: ACTIVEstatus वैरिएबल सब्सक्रिप्शन के लिए अनुबंध क्वेरी पर उपलब्ध एक फ़िल्टर है और इसका कई बार उपयोग किया जा सकता है।
डेटा की क्वेरी करते समय, यह जानना मददगार होता है:
- उपलब्ध फ़िल्टर की सूची
- क्वेरी को एक निश्चित सिंटैक्स का पालन करना होगा.
- क्वेरी फ़ील्ड वैल्यू हमेशा डॉक्युमेंटेड नहीं होती हैं। कुछ मामलों में, वैल्यू API दस्तावेज़ों को देखकर मिल सकती हैं। वैकल्पिक रूप से, जब आप एडमिन में फ़िल्टर करते हैं, तो आपको अक्सर URL में फ़ील्ड वैल्यू मिल सकती हैं। उदाहरण के लिए, कुछ ऑर्डर क्वेरी वैल्यू खोजने के लिए, एडमिन में ऑर्डर पेज को फ़िल्टर करें और फिर URL देखें।
- आप Shopify GraphiQL ऐप का इस्तेमाल करके अपने स्टोर में क्वेरी चला सकते हैं या टेस्ट कर सकते हैं।
- इस बात का ध्यान रखें कि अगर आपकी क्वेरी फ़ेल हो जाती है तो क्या होगा। अक्सर API सभी परिणाम (कोई भी नहीं की बजाय) लौटाएगा।
वापस मिला डेटा
सभी डेटा पाएं कार्रवाइयां 0 से 100 तक संसाधनों की एक सूची लौटाती हैं। आपके इस्तेमाल के मामले के आधार पर, आप इस डेटा का कई तरीकों से उपयोग करना चाह सकते हैं:
- अगर आपको हर सूची आइटम को अलग-अलग संभालना है, जैसे कि हर एक के लिए टैग जोड़ना, तो आप हर एक के लिए कार्रवाई का उपयोग कर सकते हैं।
- अगर आपको डेटा एकत्र करना है, जैसे कि यह गिनना कि कितने परिणाम लौटाए गए थे, तो आप गिनती या योग कार्रवाइयों का उपयोग कर सकते हैं।
- अगर आपको सूची को आउटपुट करने की ज़रूरत है, जैसे कि सभी आइटम के साथ एक ईमेल भेजना, तो आप बाद की कार्रवाइयों में सीधे लौटाए गए डेटा का उपयोग कर सकते हैं।
इस कार्रवाई के बाद के चरणों में लौटाए गए डेटा को एक्सेस करने के लिए, सब्सक्रिप्शन अनुबंध डेटा पाएं नाम के वैरिएबल का उपयोग करें, जो सब्सक्रिप्शन के लिए अनुबंधों की एक सूची है। आप इस वैरिएबल का उपयोग स्थितियों और कार्रवाइयों दोनों में कर सकते हैं। उदाहरण के लिए, आप अंदरूनी ईमेल भेजें कार्रवाई में ऑर्डर की सूची इस तरह भेज सकते हैं:
{% for single_contract in GetSubscriptionContractData %}
* {{ single_contract.name }}
{% endfor %}ट्रिगर
आप इस एक्शन का उपयोग किसी भी वर्कफ़्लो में कर सकते हैं, जिसमें शेड्यूल किया गया समय ट्रिगर भी शामिल है। शेड्यूल किया गया समय ट्रिगर का उपयोग करने वाले वर्कफ़्लो में, वर्कफ़्लो किसी इवेंट के परिणाम के बजाय, आपके द्वारा निर्दिष्ट समय पर शुरू होता है। चूंकि आपके स्टोर या किसी ऐप से कोई खास इवेंट नहीं होता है जो वर्कफ़्लो शुरू करता है, इसलिए इसमें अपने-आप कोई डेटा शामिल नहीं होता है।