ফিল্টার তালিকা প্রতিক্রিয়া

Display & Video 360 API-এর বেশিরভাগ পরিষেবাগুলি প্রচুর পরিমাণে সংস্থান পুনরুদ্ধারের জন্য একটি LIST পদ্ধতি প্রদান করে। এই LIST পদ্ধতিগুলি সাধারণত filter ক্যোয়ারী প্যারামিটারের মাধ্যমে ফিল্টারিং ফলাফল সমর্থন করে। শুধুমাত্র আপনার যা প্রয়োজন তা পুনরুদ্ধার করে আপনার API ব্যবহার অপ্টিমাইজ করতে এই প্যারামিটারটি ব্যবহার করুন।

এই নির্দেশিকাটি দেখায় কিভাবে কার্যকরভাবে filter প্যারামিটার ব্যবহার করতে হয়।

ফিল্টার গঠন

একটি filter প্যারামিটার মান হল একটি স্ট্রিং, যা এক বা একাধিক সীমাবদ্ধতা নিয়ে গঠিত যা AND বা OR অপারেটরগুলির সাথে একত্রিত করা যেতে পারে এবং বন্ধনী ব্যবহার করে গোষ্ঠীবদ্ধ করা যেতে পারে।

সীমাবদ্ধতাগুলি {field} {operator} {value} ফর্মের। এখানে একটি উদাহরণ:

entityStatus="ENTITY_STATUS_ACTIVE"

ফিল্টার স্ট্রিং দৈর্ঘ্য 500 অক্ষরের বেশি হতে পারে না। আপনার ফিল্টার স্ট্রিং 500 অক্ষরের বেশি হলে, নিম্নলিখিতগুলির মধ্যে একটি করুন:

  • যুক্তিটিকে একাধিক ফিল্টার স্ট্রিংগুলিতে বিভক্ত করুন এবং পৃথক LIST অনুরোধগুলি ব্যবহার করে সংস্থানগুলি পুনরুদ্ধার করুন৷
  • ফিল্টার স্ট্রিং থেকে কিছু যুক্তি সরান, এবং স্থানীয়ভাবে পুনরুদ্ধার করা সংস্থানগুলি ফিল্টার করতে এটি ব্যবহার করুন।

যুক্তি সঠিকভাবে প্রয়োগ করা হয়েছে তা নিশ্চিত করতে উদ্ধৃতিতে সীমাবদ্ধতার মানগুলি মোড়ানো।

আপনি যদি ক্লায়েন্ট লাইব্রেরি ব্যবহার না করে সরাসরি LIST কল করেন তবে আপনার ফিল্টার স্ট্রিংগুলি URL-এনকোড করুন।

আপনার প্রশ্নগুলি বিন্যাস করার বিষয়ে আরও বিশদের জন্য সীমাবদ্ধতার মধ্যে যুক্তি দেখুন।

ফিল্টারযোগ্য ক্ষেত্র

প্রতিটি LIST পদ্ধতির ফিল্টারযোগ্য ক্ষেত্রগুলি পদ্ধতির filter পরামিতি বিবরণে তালিকাভুক্ত করা হয়েছে। বেশিরভাগ ক্ষেত্রে, আপনি একটি রিসোর্সের স্ট্যান্ডার্ড ফিল্ডের একটি উপসেটে ফিল্টার করতে পারেন। কিছু বিরল ক্ষেত্রে, অতিরিক্ত ক্ষেত্র রয়েছে যা আপনি শুধুমাত্র ফিল্টারিংয়ের জন্য ব্যবহার করতে পারেন।

প্যারামিটারের বর্ণনার প্রতিটি ক্ষেত্র নিম্নলিখিত তুলনামূলক অপারেটরগুলির মধ্যে অন্তত একটিকে সমর্থন করে:

তুলনামূলক অপারেটর
EQUALS (=) সম্পদ ক্ষেত্রের মান প্রদত্ত মানের সমান।

উদাহরণ: entityStatus="ENTITY_STATUS_ACTIVE"

LESS THAN OR EQUAL TO (<=) রিসোর্স ক্ষেত্রের মান প্রদত্ত মানের থেকে কম বা সমান। একটি তারিখ বা তারিখ সময় তুলনা করার সময় প্রায়ই ব্যবহৃত হয়।

উদাহরণ: updateTime<="2023-04-01T12:00:00Z"

GREATER THAN OR EQUAL TO (>=) রিসোর্স ক্ষেত্রের মান প্রদত্ত মানের চেয়ে বেশি বা সমান। একটি তারিখ বা তারিখ সময় তুলনা করার সময় প্রায়ই ব্যবহৃত হয়।

উদাহরণ: updateTime>="2023-03-01T12:00:00Z"

HAS (:) সম্পদ ক্ষেত্রের মান প্রদত্ত মান ধারণ করে। যদি রিসোর্স ক্ষেত্রটি একটি স্ট্রিং হয়, তাহলে প্রদত্ত মানটি একটি বিদ্যমান সাবস্ট্রিং কিনা তা পরীক্ষা করবে। যদি রিসোর্স ফিল্ড একটি অ্যারে হয়, তাহলে অ্যারেতে প্রদত্ত মান রয়েছে কিনা তা পরীক্ষা করবে।

উদাহরণ: lineItemIds:"1234"

যদি প্যারামিটারের বর্ণনায় ক্ষেত্রের জন্য কোনো অপারেটর নির্দিষ্ট করা না থাকে, তাহলে আপনি শুধুমাত্র EQUALS (=) অপারেটর ব্যবহার করতে পারেন। কিছু ক্ষেত্র একাধিক অপারেটর সমর্থন করে।

কিছু ফিল্টারযোগ্য ক্ষেত্র, যেমন তারিখ এবং সময়ের জন্য, একটি নির্দিষ্ট বিন্যাস অনুসরণ করার জন্য তুলনামূলক মান প্রয়োজন। filter প্যারামিটারের বিবরণে ক্ষেত্রের পাশে বিন্যাসটি নির্দিষ্ট করা হয়েছে।

সীমাবদ্ধতার মধ্যে যুক্তি

আপনি আপনার LIST অনুরোধ থেকে প্রতিক্রিয়া সংকীর্ণ বা প্রসারিত করতে একাধিক সীমাবদ্ধতা একত্রিত করতে পারেন।

আপনি সাধারণত AND এবং OR লজিক্যাল অপারেটরগুলির সাথে একাধিক সীমাবদ্ধতা একত্রিত করতে পারেন। প্রতিটি LIST পদ্ধতি নির্দিষ্ট করে যে এটি কোন অপারেটর সমর্থন করে। কিছু পদ্ধতি শুধুমাত্র filter প্যারামিটারে একটি একক সীমাবদ্ধতা ব্যবহার করে সমর্থন করে।

AND বা OR লজিক্যাল অপারেটর দিয়ে ফিল্টার স্ট্রিং তৈরি করার সময় নিম্নলিখিত সীমাবদ্ধতাগুলি বিবেচনা করুন:

  • AND অবশ্যই বিধিনিষেধ বা সীমাবদ্ধতার গোষ্ঠীর মধ্যে ব্যবহার করা উচিত, যা বিভিন্ন ক্ষেত্র ফিল্টার করে, অথবা একই ক্ষেত্র ভিন্নভাবে ফিল্টার করে। এখানে কিছু উদাহরণঃ:
    • updateTime>="2023-03-01T12:00:00Z" AND entityStatus="ENTITY_STATUS_ACTIVE"
    • updateTime>="2023-03-01T12:00:00Z" AND updateTime<="2023-04-01T12:00:00Z" AND (entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED")
  • OR একই ক্ষেত্রের দ্বারা ফিল্টার করা পৃথক সীমাবদ্ধতার মধ্যে ব্যবহার করা আবশ্যক। এখানে একটি উদাহরণ:
    • (entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED") AND (lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR lineItemType="LINE_ITEM_TYPE_VIDEO_DEFAULT")

  • আপনি দুটি গ্রুপের সীমাবদ্ধতা একত্রিত করতে OR ব্যবহার করতে পারবেন না। পরিবর্তে বিভিন্ন ফিল্টার মান সহ একাধিক LIST অনুরোধ ব্যবহার করুন। উদাহরণস্বরূপ, নিম্নলিখিত পৃথক LIST অনুরোধগুলি ব্যবহার করুন:

    • (lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" AND insertionOrderId="123")
    • (lineItemType="LINE_ITEM_TYPE_VIDEO_DEFAULT" AND insertionOrderId="456")

    তাদের একত্রিত করতে OR অপারেটর ব্যবহার করবেন না:

    (lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" AND insertionOrderId="123") OR (lineItemType="LINE_ITEM_TYPE_VIDEO_DEFAULT" AND insertionOrderId="456")

  • যদি আপনি একটি ফিল্টার স্ট্রিং-এ গোষ্ঠীবদ্ধ সীমাবদ্ধতার জন্য সেগুলি ব্যবহার না করেন তাহলে বন্ধনীগুলি উহ্য হতে পারে৷ উদাহরণস্বরূপ, নিম্নলিখিত ফিল্টার স্ট্রিং:

    updateTime>="2023-03-01T12:00:00Z" AND entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED" OR entityStatus="ENTITY_STATUS_DRAFT"

    হিসাবে ব্যাখ্যা করা হয়:

    updateTime>="2023-03-01T12:00:00Z" AND (entityStatus="ENTITY_STATUS_ACTIVE" OR entityStatus="ENTITY_STATUS_PAUSED" OR entityStatus="ENTITY_STATUS_DRAFT")