সাবস্ক্রিপশন বিলিংয়ের প্রচেষ্টার ডেটা পান

যেসব ওয়ার্কফ্লোতে সাবস্ক্রিপশন বিলিংয়ের প্রচেষ্টার ডেটা প্রয়োজন হয়, সেখানে আপনার স্টোর থেকে অর্ডারের তথ্য পুনরুদ্ধার করতে সাবস্ক্রিপশন বিলিংয়ের প্রচেষ্টার ডেটা পান অ্যাকশনটি ব্যবহার করতে পারেন।

কনফিগারেশন

ফিল্ড

সাবস্ক্রিপশন বিলিংয়ের প্রচেষ্টার ডেটা পান অ্যাকশনে নিচের ফিল্ডগুলো রয়েছে, যা কোয়েরি তৈরি করতে ব্যবহার করা হয়:

ডেটা পান অ্যাকশনগুলোতে যেসব ফিল্ড ব্যবহার করা হয়।
ফিল্ডবিবরণ
ডেটা সাজানোর ভিত্তিপ্রয়োজনীয়। যেসব প্যারামিটারের ভিত্তিতে সার্চ কোয়েরির রিটার্ন করা ডেটা সাজানো হয়।
ফলাফলের সর্বোচ্চ সংখ্যাপ্রয়োজনীয়। আপনার বেছে নেওয়া সার্চ কোয়েরি থেকে সর্বোচ্চ যতগুলো ফলাফল রিটার্ন করা যেতে পারে। আপনি একবারে সর্বোচ্চ 100টি রিটার্ন করতে পারবেন।
কোয়েরিপ্রয়োজনীয়। সাধারণ কোয়েরিগুলো থেকে বেছে নিন বা নিজের মতো তৈরি করতে অ্যাডভান্সড নির্বাচন করুন।

কোয়েরি স্ট্রিং

গত তিন দিনে তৈরি হওয়া সাবস্ক্রিপশন বিলিংয়ের প্রচেষ্টাগুলো পাওয়ার জন্য এটি একটি উদাহরণ কোয়েরি:

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

created_at ভেরিয়েবলটি সাবস্ক্রিপশন বিলিংয়ের প্রচেষ্টা কোয়েরি-তে উপলব্ধ একটি ফিল্টার এবং এটি সাবস্ক্রিপশন বিলিংয়ের প্রচেষ্টার জন্য নির্দিষ্ট এরর মেসেজ বেছে নিতে ব্যবহার করা যেতে পারে।

ডেটার কোয়েরি করার সময় এটি জানা সহায়ক হয়:

  • উপলব্ধ সাবস্ক্রিপশন বিলিংয়ের প্রচেষ্টা ফিল্টারের তালিকা
  • কোয়েরিগুলোর ক্ষেত্রে একটি নির্দিষ্ট সিনট্যাক্স অনুসরণ করতে হবে
  • কোয়েরি ফিল্ডের ভ্যালু সবসময় নথিবদ্ধ থাকে না। কিছু ক্ষেত্রে, API ডক্স দেখলে ভ্যালুগুলো পাওয়া যেতে পারে। এছাড়া, ফিল্টার করার সময় আপনি অ্যাডমিনের URL-এ প্রায়ই ফিল্ডের ভ্যালুগুলো খুঁজে পেতে পারেন। উদাহরণস্বরূপ, কিছু অর্ডার কোয়েরির ভ্যালু খুঁজতে অ্যাডমিনের 'অর্ডার' পৃষ্ঠায় ফিল্টার করুন এবং তারপর URL চেক করুন।
  • আপনি Shopify GraphiQL অ্যাপ ব্যবহার করে আপনার শপে একটি কোয়েরি রান করতে বা পরীক্ষা করতে পারেন।
  • আপনার কোয়েরি ব্যর্থ হলে কী ঘটে সে বিষয়ে সতর্ক থাকুন। প্রায়ই API কোনো ফলাফল না দেওয়ার পরিবর্তে সব ফলাফল রিটার্ন করে।

রিটার্ন করা ডেটা

সব ডেটা পান অ্যাকশন 0 থেকে 100টি রিসোর্সের একটি তালিকা রিটার্ন করে। আপনার ব্যবহারের ক্ষেত্রের ওপর ভিত্তি করে, আপনি এই ডেটা বিভিন্ন উপায়ে ব্যবহার করতে চাইতে পারেন:

  • আপনার যদি প্রতিটি তালিকার আইটেম আলাদাভাবে পরিচালনা করতে হয়, যেমন প্রতিটির জন্য একটি ট্যাগ যোগ করা, তাহলে আপনি For each অ্যাকশনটি ব্যবহার করতে পারেন।
  • আপনার যদি ডেটা একত্রিত করার প্রয়োজন হয়, যেমন কতগুলো ফলাফল রিটার্ন করা হয়েছে তা গণনা করা, তাহলে আপনি Count বা Sum অ্যাকশন ব্যবহার করতে পারেন।
  • আপনার যদি তালিকাটি আউটপুট করার প্রয়োজন হয়, যেমন সব আইটেম সহ একটি ইমেইল পাঠানো, তাহলে আপনি পরবর্তী অ্যাকশনগুলোতে রিটার্ন করা ডেটা সরাসরি ব্যবহার করতে পারেন।

এই অ্যাকশনের পরবর্তী ধাপগুলোতে রিটার্ন করা ডেটা অ্যাক্সেস করতে সাবস্ক্রিপশন বিলিংয়ের প্রচেষ্টার ডেটা পান নামের ভেরিয়েবলটি ব্যবহার করুন, যা হলো সাবস্ক্রিপশন বিলিংয়ের প্রচেষ্টার একটি তালিকা। আপনি শর্ত ও অ্যাকশন, উভয় ক্ষেত্রেই এই ভেরিয়েবলটি ব্যবহার করতে পারেন। উদাহরণস্বরূপ, আপনি অভ্যন্তরীণ ইমেইল পাঠান অ্যাকশনে সাবস্ক্রিপশন বিলিংয়ের প্রচেষ্টার তালিকাটি এভাবে পাঠাতে পারেন:

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

উদাহরণ

উদাহরণস্বরূপ, প্রতি রবিবার সকাল 9:00-টায় রান করার জন্য একটি ওয়ার্কফ্লো শিডিউল করা আছে। গত সপ্তাহে তৈরি হওয়া সাবস্ক্রিপশন বিলিংয়ের প্রচেষ্টার ডেটা সংগ্রহ করতে Get subscription billing attempt data অ্যাকশন ব্যবহার করা হয়। যদি সেগুলোতে কোনও ত্রুটির মেসেজ থাকে, তবে বিলিংয়ের প্রচেষ্টাগুলো ইমেইল করতে হবে।