گفٹ کارڈ کا ڈیٹا حاصل کریں

ایسے ورک فلو جن میں گفٹ کارڈ کے ڈیٹا کی ضرورت ہوتی ہے، آپ اپنے سٹور سے گفٹ کارڈ کی معلومات حاصل کرنے کے لیے Get gift card data ایکشن استعمال کر سکتے ہیں۔

اہم بات یہ ہے کہ آپ کے سٹور میں گفٹ کارڈ پروڈکٹ، جو گفٹ کارڈ بنانے کے لیے استعمال ہوتی ہیں، اور خود گفٹ کارڈ، جو کہ وہ اصل گفٹ کارڈ ہیں جنہیں کسٹمر خریداری کرنے کے لیے استعمال کر سکتے ہیں، دونوں موجود ہیں۔ Get gift card data ایکشن خود گفٹ کارڈ کے بارے میں معلومات حاصل کرتا ہے۔ گفٹ کارڈ پروڈکٹ کے بارے میں معلومات حاصل کرنے کے لیے، Get product data یا Get product variant data ایکشن استعمال کریں۔

کنفیگریشن

فیلڈ

Get gift card data ایکشن میں درج ذیل فیلڈ شامل ہیں، جو کیوری بنانے کے لیے استعمال ہوتی ہیں:

Query String

یہ ان گفٹ کارڈ کو حاصل کرنے کی ایک مثال query ہے جو پچھلے دن اپ ڈیٹ کیے گئے تھے:

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

created_at ویری ایبل ایک فلٹر ہے جو gift cards query پر دستیاب ہے اور اسے متعدد بار استعمال کیا جا سکتا ہے یا دیگر ویری ایبل کے ساتھ ملایا جا سکتا ہے۔ scheduledAt Liquid ویری ایبل ان workflow پر دستیاب ہے جو Scheduled time trigger استعمال کرتے ہیں۔ date_minus Liquid ٹیگ ایک مخصوص Flow ٹیگ ہے جو آپ کو تاریخ سے وقت منہا کرنے کی سہولت دیتا ہے۔

ڈیٹا کی querying کرتے وقت، یہ جاننا مفید ہے:

• دستیاب گفٹ کارڈ فلٹر کی فہرست

• Query کو ایک مخصوص syntax کی پیروی کرنی چاہیے۔

• Query فیلڈ کی ویلیو ہمیشہ دستاویزی شکل میں نہیں ہوتیں۔ کچھ صورتوں میں، API docs دیکھ کر ویلیو کو تلاش کیا جا سکتا ہے۔ متبادل کے طور پر، جب آپ فلٹر کرتے ہیں تو آپ اکثر admin میں URL میں فیلڈ کی ویلیو تلاش کر سکتے ہیں۔ مثال کے طور پر، کچھ آرڈر query کی ویلیو تلاش کرنے کے لیے، admin میں Orders کے صفحے کو فلٹر کریں، اور پھر URL چیک کریں۔

• آپ Shopify GraphiQL app کا استعمال کر کے اپنے سٹور میں query چلا یا ٹیسٹ کر سکتے ہیں۔

• اس بات کا دھیان رکھیں کہ اگر آپ کی query ناکام ہو جائے تو کیا ہوتا ہے۔ اکثر API تمام نتائج واپس کر دے گا (بجائے اس کے کہ کچھ بھی نہیں)۔

واپس کیا گیا ڈیٹا

تمام Get data ایکشن 0 اور 100 وسائل کے درمیان کسی بھی جگہ کی فہرست واپس کرتے ہیں۔ آپ کے استعمال کے کیس پر منحصر ہے، آپ اس ڈیٹا کو مختلف طریقوں سے استعمال کرنا چاہیں گے:

• اگر آپ کو فہرست کے ہر آئٹم کو انفرادی طور پر ہینڈل کرنے کی ضرورت ہے، جیسے کہ ہر ایک کے لیے ایک ٹیگ شامل کرنا، تو آپ For each ایکشن استعمال کر سکتے ہیں۔
• اگر آپ کو ڈیٹا اکٹھا کرنے کی ضرورت ہے، جیسے کہ کتنے نتائج واپس آئے ان کی گنتی کرنا، تو آپ Count یا Sum ایکشن استعمال کر سکتے ہیں۔
• اگر آپ کو فہرست آؤٹ پٹ کرنے کی ضرورت ہے، جیسے کہ تمام آئٹم کے ساتھ ای میل بھیجنا، تو آپ واپس کیے گئے ڈیٹا کو براہ راست بعد کے ایکشن میں استعمال کر سکتے ہیں۔

اس ایکشن کے بعد آنے والے اقدامات میں واپس کیے گئے ڈیٹا تک رسائی حاصل کرنے کے لیے، Get gift card data نامی ویری ایبل استعمال کریں، جو گفٹ کارڈ کی ایک فہرست ہے۔ آپ اس ویری ایبل کو شرائط اور ایکشن دونوں میں استعمال کر سکتے ہیں۔ مثال کے طور پر، آپ گفٹ کارڈ کی فہرست کو Send internal email ایکشن میں اس طرح بھیج سکتے ہیں:

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

ٹرگر

آپ اس ایکشن کو کسی بھی workflow میں استعمال کر سکتے ہیں، بشمول Scheduled time ٹرگر۔ Scheduled time ٹرگر استعمال کرنے والے workflow میں، ایونٹ کے نتیجے کی بجائے آپ کا مخصوص کردہ وقت پر workflow شروع ہوتا ہے۔ چونکہ آپ کے سٹور میں یا کسی ایپ کی جانب سے کوئی مخصوص ایونٹ نہیں ہے جو workflow شروع کرے، اس لیے کوئی ڈیٹا خود بخود شامل نہیں ہوتا ہے۔

API کی تفصیلات

• گفٹ کارڈ ریسورس
• گفٹ کارڈ query فلٹر