সার্চ অ্যাডস ৩৬০ রিপোর্টিং এপিআই সকল ব্যবহারকারীর জন্য সর্বোত্তম সিস্টেম পারফরম্যান্স নিশ্চিত করতে এপিআই অপারেশনের উপর সীমাবদ্ধতা আরোপ করে।
মূল্য নির্ধারণ
Search Ads 360-এর সামগ্রিক মূল্যের মধ্যেই এর রিপোর্টিং এপিআই (Reporting API) ব্যবহারের সুবিধা অন্তর্ভুক্ত। এই এপিআই ব্যবহারের জন্য কোনো অতিরিক্ত ফি নেই।
কোয়েরি সীমা
Search বা SearchStream মেথডের মাধ্যমে সম্পাদিত কোয়েরি অপারেশনগুলোর ক্ষেত্রে নিম্নলিখিত সীমাবদ্ধতাগুলো প্রযোজ্য।
- প্রতি ব্যবহারকারী প্রতি প্রকল্পে প্রতি মিনিটে ৩,০০০ কোয়েরি
- প্রতি প্রকল্পে প্রতি মিনিটে ৩,০০০ কোয়েরি
- প্রতি প্রকল্পে প্রতিদিন ১৫০,০০০ কোয়েরি
দৈনিক এপিআই পরিচালনার সীমা
প্রতিটি গুগল ক্লাউড প্রজেক্টে সম্পাদিত এপিআই অপারেশনের সংখ্যার উপর ভিত্তি করে দৈনিক এপিআই ব্যবহারের সীমা নির্ধারণ করা হয়।
একটি একক কোয়েরি বা রিপোর্টকে একটি অপারেশন হিসেবে গণ্য করা হয়, তার ফলাফল SearchAds360Service.SearchStream এর মাধ্যমে স্ট্রিম করা হোক বা SearchAds360Service.Search কল থেকে পেজ করা হোক। আরও জানুন ।
নিম্নোক্ত সারণিতে হিসাবরক্ষণের কিছু উদাহরণ দেওয়া হলো:
| এপিআই অনুরোধ | দৈনিক সীমার মধ্যে গণনাকৃত কার্যক্রম |
|---|---|
অভিযান: Searchসংখ্যা: ৫৩টি বিজ্ঞাপন গ্রুপ পরিষেবা: SearchAds360Service | ১ |
অপারেশন: SearchStreamসংখ্যা: ৪৫টি প্রচারাভিযান পরিষেবা: SearchAds360Service | ১ |
যেসব অনুরোধ এই সীমা লঙ্ঘন করে, সেগুলো RESOURCE_EXHAUSTED ত্রুটিসহ প্রত্যাখ্যান করা হয়।
অনুসন্ধানের অনুরোধ
একটি Search বা SearchStream অনুরোধ ব্যবহারকারীর দৈনিক অপারেশন কোটার বিপরীতে একটি অপারেশন হিসাবে গণ্য হয়। ব্যাচের সংখ্যা নির্বিশেষে একটি SearchStream অনুরোধকে একটি এপিআই অপারেশন হিসাবে গণনা করা হয়।
gRPC সীমাবদ্ধতা
Search Ads 360 রিপোর্টিং এপিআই-এর সমস্ত ক্লায়েন্ট লাইব্রেরি অনুরোধ এবং প্রতিক্রিয়া তৈরি করার জন্য 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 Query Language কোয়েরি করার সময়, একটি IN ক্লজের মধ্যে আইটেমের সর্বোচ্চ সংখ্যা হলো ২০,০০০। এই সীমা অতিক্রম করলে, একটি FILTER_HAS_TOO_MANY_VALUES ত্রুটি প্রদর্শিত হয়।