দাম, API-এর সীমা ও কোটা

Search Ads 360 Reporting API, API অপারেশনের উপর সীমা আরোপ করে যাতে সব ব্যবহারকারীর জন্য সিস্টেমের পারফর্ম্যান্স অপ্টিমাইজ করা যায়।

দাম

Search Ads 360 Reporting API-এর ব্যবহার Search Ads 360-এর সামগ্রিক মূল্যের মধ্যে অন্তর্ভুক্ত। API ব্যবহার করার জন্য কোনও অতিরিক্ত ফি দিতে হয় না।

কোয়েরির সীমা

Search বা SearchStream পদ্ধতির মাধ্যমে করা কোয়েরি অপারেশনের ক্ষেত্রে নিম্নলিখিত সীমা প্রযোজ্য।

  • প্রতি প্রোজেক্টে প্রতি ব্যবহারকারীর জন্য প্রতি মিনিটে ৩,০০০টি কোয়েরি
  • প্রতি প্রোজেক্টে প্রতি মিনিটে ৩,০০০টি কোয়েরি
  • প্রতি প্রোজেক্টে প্রতিদিন ১৫০,০০০ কোয়েরি

দৈনিক API অপারেশন সীমা

প্রতি Google Cloud প্রোজেক্টে করা API অপারেশনের সংখ্যার উপর ভিত্তি করে দৈনিক API ব্যবহারের সীমা নির্ধারণ করা হয়।

একটি কোয়েরি বা রিপোর্টকে একটি অপারেশন হিসেবে গণনা করা হয়, ফলাফল SearchAds360Service.SearchStream -এর মাধ্যমে স্ট্রিম করা হোক বা SearchAds360Service.Search কল থেকে পেজ করা হোক না কেন। আরও জানুন।

নিম্নলিখিত সারণীতে অ্যাকাউন্টিংয়ের কিছু উদাহরণ দেওয়া হল:

API সংক্রান্ত অনুরোধ দৈনিক সীমার মধ্যে অপারেশন গণনা করা হয়েছে
অপারেশন: Search
সংখ্যা: ৫৩টি বিজ্ঞাপন গ্রুপ
পরিষেবা: SearchAds360Service
1
অপারেশন: SearchStream
সংখ্যা: ৪৫টি ক্যাম্পেন
পরিষেবা: SearchAds360Service
1

এইসব সীমা লঙ্ঘন করে এমন অনুরোধ এই সমস্যার সাথে বাতিল করা হয়: RESOURCE_EXHAUSTED.

অনুরোধ সার্চ করুন

Search বা SearchStream অনুরোধ ব্যবহারকারীর দৈনিক অপারেশন কোটার একটি অপারেশন হিসেবে গণনা করা হয়। একটি SearchStream অনুরোধ একটি API অপারেশন হিসেবে গণ্য করা হয়, ব্যাচের সংখ্যা যাই হোক না কেন।

gRPC সংক্রান্ত সীমাবদ্ধতা

Search Ads 360 Reporting API-এর সব ক্লায়েন্ট লাইব্রেরি অনুরোধ ও উত্তর জেনারেট করার জন্য gRPC ব্যবহার করে। ডিফল্ট হিসেবে, gRPC-তে মেসেজের সাইজ ৪ এমবি।

উত্তর এই সীমা অতিক্রম করলে চলবে না। যেমন, অনেক ফিল্ড সহ সার্চের অনুরোধের ফলে এমন উত্তর জেনারেট হতে পারে যার সাইজ ৪ এমবির বেশি। এই সীমা এড়াতে, আপনি বেছে নেওয়া ফিল্ডের সংখ্যা কমাতে, পৃষ্ঠার সাইজ কমাতে বা স্ট্রিমিং ব্যবহার করতে পারেন।

এই সীমাবদ্ধতা লঙ্ঘন করে এমন অনুরোধের ক্ষেত্রে কোনও SearchAds360Error জেনারেট হবে না, তবে 429 Resource Exhausted gRPC সমস্যা জেনারেট হবে। gRPC সমস্যার কোড ও মেসেজের তালিকা দেখুন।

পৃষ্ঠা সংখ্যা অনুযায়ী অনুরোধ

পৃষ্ঠা সংখ্যাযুক্ত অনুরোধ (যেমন, সঠিক next_page_token সহ অনুরোধ) ব্যবহারকারীর দৈনিক অপারেশন কোটার মধ্যে গণনা করা হয় না। তবে, মেয়াদ শেষ হয়ে যাওয়া বা ভুল পৃষ্ঠা টোকেন সহ পেজিনেশন অনুরোধের ক্ষেত্রে ব্যতিক্রম তৈরি হবে এবং দৈনিক অপারেশন কোটার মধ্যে তা গণনা করা হবে।

সার্চ অনুরোধের মতো যেসব অনুরোধ পেজিনেট করা হয়, সেগুলিও Page size cannot exceed 10,000 rows সীমাবদ্ধতার আওতাভুক্ত এবং এই সীমা লঙ্ঘন করলে বাতিল করা হয়, সাথে এই সমস্যার কথা জানানো হয়: INVALID_PAGE_SIZE.

পেজিনেশন সম্পর্কে আরও জানতে, ফলাফলের মাধ্যমে পেজিং দেখুন।

API এক্সেপশন রিটার্ন করে এমন অনুরোধ

SearchAds360Failure দিয়ে যেসব অনুরোধ বাতিল করা হয়, সেগুলি এখনও ব্যবহারকারীর দৈনিক অপারেশন কোটার বিরুদ্ধে গণনা করা হয়।

যেসব অনুরোধ ব্যর্থ হয় কিন্তু SearchAds360Failure ফিরিয়ে দেয় না, যেমন নেটওয়ার্ক লেভেলে কোনও সমস্যার কারণে, সেগুলি ব্যবহারকারীর দৈনিক অপারেশন কোটার মধ্যে ধরা হবে না কারণ অনুরোধগুলি কখনই পরিষেবায় পৌঁছাবে না। এর একটি উদাহরণ হল নেটওয়ার্ক কানেক্টিভিটি কাজ না করা।

অন্যান্য ধরনের সীমা

একটি পুনরাবৃত্ত ফিল্ড, যেমন অপারেশনের তালিকা, যাতে একটি অনুরোধে অনেক আইটেম আছে, তাতে এই সমস্যা হতে পারে: REQUEST_SIZE_LIMIT_EXCEEDED. অন্যান্য সমস্যার কারণেও এই একই সমস্যার মেসেজ দেখানো হতে পারে।

Search Ads 360 কোয়েরি ল্যাঙ্গুয়েজ কোয়েরি করার সময়, IN ক্লজের মধ্যে আইটেমের সর্বাধিক সংখ্যা হল ২০,০০০। আপনি সেই সীমা অতিক্রম করলে, একটি FILTER_HAS_TOO_MANY_VALUES সমস্যা রিটার্ন করা হয়।