সার্চ বিজ্ঞাপন 360 রিপোর্টিং API সমস্ত ব্যবহারকারীর জন্য সর্বোত্তম সিস্টেম কার্যকারিতা নিশ্চিত করতে API ক্রিয়াকলাপগুলিতে সীমাবদ্ধতা প্রয়োগ করে।
মূল্য নির্ধারণ
সার্চ বিজ্ঞাপন 360 রিপোর্টিং API-এর ব্যবহার সার্চ বিজ্ঞাপন 360-এর সামগ্রিক মূল্যের মধ্যে অন্তর্ভুক্ত। API ব্যবহার করার জন্য কোনও অতিরিক্ত ফি নেই।
ক্যোয়ারী সীমা
নিম্নলিখিত সীমাগুলি অনুসন্ধান বা অনুসন্ধান স্ট্রিম পদ্ধতির মাধ্যমে সম্পাদিত ক্যোয়ারী অপারেশনগুলিতে প্রযোজ্য।
- ব্যবহারকারী প্রতি প্রকল্প প্রতি মিনিটে 3,000 প্রশ্ন
- প্রকল্প প্রতি মিনিটে 3,000 প্রশ্ন
- প্রকল্প প্রতি প্রতিদিন 150,000 প্রশ্ন
দৈনিক API অপারেশন সীমা
দৈনিক API ব্যবহারের সীমা Google ক্লাউড প্রকল্পের প্রতি তৈরি API অপারেশনের সংখ্যার উপর ভিত্তি করে।
SearchAds360Service.SearchStream এর মাধ্যমে ফলাফল স্ট্রিম করা বা SearchAds360Service.Search কল থেকে পেজ করা যাই হোক না কেন, একটি একক ক্যোয়ারী বা রিপোর্টকে একটি অপারেশন হিসেবে গণনা করা হয়। আরও জানুন
নিম্নলিখিত সারণী অ্যাকাউন্টিং এর কিছু উদাহরণ দেয়:
| API অনুরোধ | ক্রিয়াকলাপগুলি দৈনিক সীমার দিকে গণনা করা হয়েছে৷ |
|---|---|
অপারেশন: Searchগণনা: 53টি বিজ্ঞাপন গ্রুপ পরিষেবা: | 1 |
অপারেশন: SearchStreamগণনা: 45টি প্রচারণা পরিষেবা: | 1 |
এই সীমা লঙ্ঘনকারী অনুরোধগুলি এই ত্রুটির সাথে প্রত্যাখ্যান করা হয়: RESOURCE_EXHAUSTED ।
অনুসন্ধান অনুরোধ
একটি Search বা SearchStream অনুরোধ ব্যবহারকারীর দৈনিক অপারেশন কোটার বিরুদ্ধে একটি অপারেশন হিসাবে গণনা করা হয়৷ একটি SearchStream অনুরোধ ব্যাচ সংখ্যা নির্বিশেষে একটি API অপারেশন হিসাবে গণনা করা হয়।
gRPC সীমাবদ্ধতা
সমস্ত Search Ads 360 Reporting API ক্লায়েন্ট লাইব্রেরি অনুরোধ এবং প্রতিক্রিয়া তৈরি করার জন্য gRPC ব্যবহার করে। ডিফল্টরূপে, gRPC-এর বার্তার আকার 4 MB থাকে।
প্রতিক্রিয়া এই সীমা অতিক্রম করা উচিত নয়. উদাহরণস্বরূপ, একটি অনুসন্ধান অনুরোধ যাতে অনেকগুলি ক্ষেত্র অন্তর্ভুক্ত থাকে একটি প্রতিক্রিয়া তৈরি করতে পারে যার আকার 4 MB ছাড়িয়ে যায়৷ এই সীমা এড়াতে, আপনি নির্বাচিত ক্ষেত্রের সংখ্যা কমাতে পারেন, পৃষ্ঠার আকার কমাতে পারেন বা স্ট্রিমিং ব্যবহার করতে পারেন।
এই সীমাবদ্ধতা লঙ্ঘন করে এমন অনুরোধগুলি একটি 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 । এই একই ত্রুটি বার্তা অন্যান্য সমস্যার কারণেও হতে পারে।
একটি অনুসন্ধান বিজ্ঞাপন 360 কোয়েরি ভাষা ক্যোয়ারী করার সময়, একটি IN ধারার মধ্যে আইটেমের সর্বাধিক সংখ্যা 20,000। আপনি সেই সীমা অতিক্রম করলে, একটি FILTER_HAS_TOO_MANY_VALUES ত্রুটি ফেরত দেওয়া হবে৷