مارکیٹ کا ڈیٹا حاصل کریں

جن ورک فلو میں مارکیٹ کے ڈیٹا کی ضرورت ہوتی ہے، ان میں آپ اپنے Shopify سٹور سے مارکیٹ کی معلومات حاصل کرنے کے لیے Get market data ایکشن استعمال کر سکتے ہیں۔ Markets علاقوں یا مقامات کے وہ گروپ ہیں جنہیں آپ فروخت کے لیے ہدف بناتے ہیں۔

نوٹ

یہ Get data ایکشن کی ایک قسم ہے۔ Scheduled time ٹرگر اور For each لوپ کے ساتھ اس قسم کے ایکشن کا طریقہ استعمال سمجھنے کے لیے، Shopify Flow میں شیڈول، ڈیٹا حاصل کرنا، اور لوپنگ ورک فلو دیکھیں۔

کنفیگریشن

فیلڈ

Get market data ایکشن میں درج ذیل فیلڈ شامل ہیں:

Get data ایکشن میں استعمال ہونے والی فیلڈ۔

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

کوئری سٹرنگ

تمام فعال مارکیٹ حاصل کرنے کے لیے یہ ایک کوئری کی مثال ہے:

status:ACTIVE

status متغیر Markets کوئری پر دستیاب ایک فلٹر ہے اور اسے متعدد بار استعمال کیا جا سکتا ہے یا دیگر متغیرات کے ساتھ ملایا جا سکتا ہے۔

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

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

• کوئری کے لیے ایک مخصوص سنٹیکس کی پیروی کرنا لازمی ہے

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

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

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

لوٹایا گیا ڈیٹا

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

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

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

{% for single_market in GetMarketData %}
    * {{ single_market.name }}
    {% endfor %}

نوٹ

اگر ایک Get data ایکشن کو ایک ہی ورک فلو میں متعدد بار استعمال کیا جاتا ہے، تو متغیر کے نام میں ایک عدد شامل کر دیا جاتا ہے۔ مثال کے طور پر، ایسے ورک فلو میں جو Get order data ایکشن کو دو بار استعمال کرتا ہے، لوٹائے گئے ڈیٹا کا پہلا متغیر getOrderData اور دوسرا متغیر getOrderData1 ہوتا ہے۔ اس نام کو حسب ضرورت نہیں بنایا جا سکتا۔

ٹرگر

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

API کا حوالہ

اس ایکشن میں استعمال ہونے والی API کے بارے میں مزید معلومات کے لیے، Markets کوئری دیکھیں۔