गिफ़्ट कार्ड डेटा पाएं

जिन वर्कफ़्लो में गिफ़्ट कार्ड डेटा की ज़रूरत होती है, उनमें आप अपने स्टोर से गिफ़्ट कार्ड की जानकारी वापस पाने के लिए गिफ़्ट कार्ड डेटा पाएं कार्रवाई का इस्तेमाल कर सकते हैं।

यह जानना ज़रूरी है कि आपके स्टोर में गिफ़्ट कार्ड प्रोडक्ट (जिनसे गिफ़्ट कार्ड बनाए जाते हैं) और असली गिफ़्ट कार्ड (जिनका इस्तेमाल ग्राहक खरीदारी के लिए करते हैं), दोनों होते हैं। गिफ़्ट कार्ड डेटा पाएं कार्रवाई असली गिफ़्ट कार्ड के बारे में जानकारी वापस पाती है। गिफ़्ट कार्ड प्रोडक्ट के बारे में जानकारी पाने के लिए, प्रोडक्ट डेटा पाएं या उत्पाद प्रकार डेटा पाएं कार्रवाइयों का इस्तेमाल करें।

कॉन्फ़िगरेशन

फ़ील्ड

गिफ़्ट कार्ड डेटा पाएं कार्रवाई में निम्नलिखित फ़ील्ड शामिल हैं, जिनका इस्तेमाल क्वेरी बनाने के लिए किया जाता है:

डेटा पाएं कार्रवाइयों में इस्तेमाल किए गए फ़ील्ड.
फ़ील्डविवरण
इसके अनुसार डेटा को सॉर्ट करेंज़रूरी है. वे पैरामीटर जिनके द्वारा सर्च क्वेरी से मिले डेटा को सॉर्ट किया जाता है।
परिणामों की अधिकतम संख्याज़रूरी है. आपके द्वारा चुनी गई सर्च क्वेरी से मिलने वाले परिणामों की अधिकतम संख्या। आप एक बार में 100 तक परिणाम पा सकते हैं।
क्वेरीज़रूरी है. सामान्य क्वेरी में से चुनें या अपनी खुद की क्वेरी बनाने के लिए एडवांस चुनें।

क्वेरी स्ट्रिंग

यह उन गिफ़्ट कार्ड को पाने के लिए एक उदाहरण क्वेरी है, जिन्हें पिछले दिन में अपडेट किया गया था:

created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'

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

डेटा की क्वेरी करते समय, यह जानना मददगार होता है:

  • उपलब्ध गिफ़्ट कार्ड फ़िल्टर की सूची

  • क्वेरी को एक निश्चित सिंटैक्स का पालन करना चाहिए.

  • क्वेरी फ़ील्ड की वैल्यू हमेशा दस्तावेज़ में शामिल नहीं होती हैं. कुछ मामलों में, API डॉक्स को देखकर वैल्यू मिल सकती हैं. इसके अलावा, जब आप फ़िल्टर करते हैं, तो आप अक्सर एडमिन में मौजूद URL में फ़ील्ड की वैल्यू पा सकते हैं. उदाहरण के लिए, ऑर्डर क्वेरी की कुछ वैल्यू खोजने के लिए, एडमिन में ऑर्डर पेज पर फ़िल्टर लगाएं और फिर URL देखें.

  • आप Shopify GraphiQL ऐप का उपयोग करके अपने स्टोर में क्वेरी चला सकते हैं या उसकी जांच कर सकते हैं.

  • इस बात का ध्यान रखें कि आपकी क्वेरी फ़ेल होने पर क्या होता है. अक्सर API कोई भी परिणाम न देने के बजाय सभी परिणाम दे देता है.

प्राप्त डेटा

सभी डेटा पाएं कार्रवाइयां 0 से 100 तक के संसाधनों की एक सूची देती हैं. आपके उपयोग के मामले के आधार पर, आप इस डेटा का विभिन्न तरीकों से उपयोग करना चाह सकते हैं:

  • अगर आपको सूची के हर आइटम को अलग-अलग हैंडल करना है, जैसे हर एक में टैग जोड़ना, तो आप हर एक के लिए कार्रवाई का उपयोग कर सकते हैं.
  • अगर आपको डेटा एग्रीगेट करना है, जैसे कि यह गिनना कि कितने परिणाम मिले, तो आप गिनती करें या जोड़ें कार्रवाइयों का उपयोग कर सकते हैं.
  • अगर आपको सूची का आउटपुट देना है, जैसे कि सभी आइटम के साथ ईमेल भेजना, तो आप बाद की कार्रवाइयों में सीधे तौर पर प्राप्त डेटा का उपयोग कर सकते हैं.

इस कार्रवाई के बाद के चरणों में प्राप्त डेटा को एक्सेस करने के लिए, गिफ़्ट कार्ड डेटा पाएं नामक वेरिएबल का उपयोग करें, जो गिफ़्ट कार्ड की एक सूची है. आप इस वेरिएबल का उपयोग स्थितियों और कार्रवाइयों दोनों में कर सकते हैं. उदाहरण के लिए, आप आंतरिक ईमेल भेजें जैसी कार्रवाई में गिफ़्ट कार्ड की सूची इस तरह भेज सकते हैं:

{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}

ट्रिगर

आप इस कार्रवाई का उपयोग किसी भी वर्कफ़्लो में कर सकते हैं, जिसमें तय समय वाला ट्रिगर भी शामिल है. जिस वर्कफ़्लो में तय समय वाले ट्रिगर का उपयोग किया जाता है, उसमें वर्कफ़्लो आपके द्वारा तय किए गए समय पर शुरू होता है, न कि किसी इवेंट के परिणामस्वरूप. क्योंकि आपके स्टोर में या किसी ऐप से ऐसा कोई खास इवेंट नहीं होता है जो वर्कफ़्लो शुरू करे, इसलिए इसमें कोई भी डेटा अपने-आप शामिल नहीं होता है.

API विवरण