سبسکرپشن بلنگ کی کوشش کا ڈیٹا حاصل کریں

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

کنفیگریشن

فیلڈز

سبسکرپشن بلنگ کی کوشش کا ڈیٹا حاصل کریں ایکشن میں درج ذیل فیلڈز شامل ہیں، جو کیوری بنانے کے لیے استعمال ہوتی ہیں:

ڈیٹا حاصل کریں ایکشنز میں استعمال ہونے والی فیلڈز۔
فیلڈتفصیل
ڈیٹا کو اس لحاظ سے ترتیب دیںلازمی۔ وہ پیرامیٹرز جن کے ذریعے سرچ کیوری سے موصول ہونے والے ڈیٹا کو ترتیب دیا جاتا ہے۔
نتائج کی زیادہ سے زیادہ تعدادلازمی۔ آپ کی منتخب کردہ سرچ کیوری سے حاصل ہونے والے نتائج کی زیادہ سے زیادہ مقدار۔ آپ ایک وقت میں 100 تک نتائج موصول کر سکتے ہیں۔
کیوریلازمی۔ عام کیوریز میں سے انتخاب کریں یا اپنی کیوری بنانے کے لیے ایڈوانسڈ منتخب کریں۔

کیوری سٹرنگ

پچھلے تین دنوں میں تخلیق کی گئی سبسکرپشن بلنگ کی کوششیں حاصل کرنے کے لیے یہ ایک مثالی کیوری ہے:

created_at:>'{{ createdAt | date_minus: "3 day" }}'

created_at متغیر ایک فلٹر ہے جو سبسکرپشن بلنگ کی کوشش کی کیوری پر دستیاب ہے اور اسے سبسکرپشن بلنگ کی کوششوں کے لیے مخصوص ایرر میسج منتخب کرنے کے لیے استعمال کیا جا سکتا ہے۔

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

  • دستیاب سبسکرپشن بلنگ کی کوشش کے فلٹرز کی فہرست
  • کیوریز کا ایک مخصوص سنٹیکس ہونا لازمی ہے۔
  • کیوری فیلڈ کی ویلیوز ہمیشہ دستاویزی شکل میں نہیں ہوتی ہیں۔ بعض صورتوں میں، API کی دستاویزات دیکھ کر ویلیوز تلاش کی جا سکتی ہیں۔ متبادل طور پر، جب آپ فلٹر کرتے ہیں تو آپ اکثر ایڈمن کے URLs میں فیلڈ کی ویلیوز تلاش کر سکتے ہیں۔ مثال کے طور پر، آرڈر کی کچھ کیوری ویلیوز تلاش کرنے کے لیے، ایڈمن میں آرڈرز کے صفحے کو فلٹر کریں، اور پھر URL چیک کریں۔
  • آپ Shopify GraphiQL ایپ استعمال کر کے اپنی شاپ میں کیوری کو رن یا ٹیسٹ کر سکتے ہیں۔
  • اس بات کا دھیان رکھیں کہ اگر آپ کی کیوری ناکام ہو جاتی ہے تو کیا ہوتا ہے۔ اکثر API (کسی کے بجائے) تمام نتائج واپس کر دے گی۔

موصول ہونے والا ڈیٹا

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

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

اس ایکشن کے بعد آنے والے مراحل میں موصول ہونے والے ڈیٹا تک رسائی کے لیے، سبسکرپشن بلنگ کی کوشش کا ڈیٹا حاصل کریں نامی متغیر استعمال کریں، جو سبسکرپشن بلنگ کی کوششوں کی ایک فہرست ہے۔ آپ اس متغیر کو شرائط اور ایکشنز دونوں میں استعمال کر سکتے ہیں۔ مثال کے طور پر، آپ اندرونی ای میل بھیجیں ایکشن میں سبسکرپشن بلنگ کی کوششوں کی فہرست اس طرح بھیج سکتے ہیں:

{% for getSubscriptionBillingAttemptData_item in getSubscriptionBillingAttemptData %}
  {{getSubscriptionBillingAttemptData_item.errorMessage}}
{% endfor %}

مثال

مثال کے طور پر، ایک ورک فلو کو ہر اتوار کی صبح 9:00 بجے رن ہونے کے لیے شیڈول کیا گیا ہے۔ Get subscription billing attempt data ایکشن کا استعمال پچھلے ہفتے بنائی گئی سبسکرپشن بلنگ کی کوششوں کے لیے ڈیٹا اکٹھا کرنے کے لیے کیا جاتا ہے۔ اگر ان میں کوئی ایرر میسج ہو، تو بلنگ کی کوششوں کو ای میل کریں۔

API حوالہ