API گزارشدهی تبلیغات جستجو ۳۶۰، محدودیتهایی را بر عملیات API اعمال میکند تا عملکرد بهینه سیستم را برای همه کاربران تضمین کند.
قیمتگذاری
استفاده از API گزارشدهی Search Ads 360 در قیمتگذاری کلی Search Ads 360 لحاظ شده است. هیچ هزینه اضافی برای استفاده از API وجود ندارد.
محدودیتهای پرسوجو
محدودیتهای زیر برای عملیات پرسوجو که از طریق متدهای Search یا SearchStream انجام میشوند، اعمال میشود.
- ۳۰۰۰ پرسوجو در دقیقه برای هر پروژه و هر کاربر
- ۳۰۰۰ پرسوجو در دقیقه برای هر پروژه
- ۱۵۰،۰۰۰ پرس و جو در روز برای هر پروژه
محدودیتهای روزانه عملیات API
محدودیتهای استفاده روزانه از API بر اساس تعداد عملیات API انجام شده در هر پروژه Google Cloud تعیین میشود.
یک پرسوجو یا گزارش واحد، صرف نظر از اینکه نتایج از طریق SearchAds360Service.SearchStream پخش شوند یا از فراخوانی SearchAds360Service.Search به صفحهای منتقل شوند، به عنوان یک عملیات محسوب میشود. اطلاعات بیشتر .
جدول زیر نمونههایی از حسابداری را نشان میدهد:
| درخواست API | عملیات محاسبه شده در سقف روزانه |
|---|---|
عملیات: Searchتعداد: ۵۳ گروه تبلیغاتی سرویس: SearchAds360Service | ۱ |
عملیات: SearchStreamتعداد: ۴۵ کمپین سرویس: SearchAds360Service | ۱ |
درخواستهایی که این محدودیتها را نقض کنند با خطای RESOURCE_EXHAUSTED رد میشوند.
درخواستهای جستجو
یک درخواست Search یا SearchStream به عنوان یک عملیات در سهمیه عملیات روزانه کاربر محاسبه میشود. یک درخواست SearchStream صرف نظر از تعداد دستهها، به عنوان یک عملیات API محاسبه میشود.
محدودیتهای gRPC
تمام کتابخانههای کلاینت API گزارشدهی تبلیغات جستجو ۳۶۰ از gRPC برای تولید درخواستها و پاسخها استفاده میکنند. به طور پیشفرض، gRPC اندازه پیام ۴ مگابایت دارد.
پاسخها نباید از این حد تجاوز کنند. برای مثال، یک درخواست جستجو که شامل فیلدهای زیادی است، ممکن است پاسخی با حجم بیش از ۴ مگابایت ایجاد کند. برای جلوگیری از این محدودیت، میتوانید تعداد فیلدهای انتخاب شده را کاهش دهید، اندازه صفحه را کوچک کنید یا از streaming استفاده کنید.
درخواستهایی که این محدودیت را نقض کنند، خطای SearchAds360Error ایجاد نمیکنند ، اما خطای 429 Resource Exhausted gRPC را ایجاد میکنند. به لیست کدهای خطا و پیامهای gRPC مراجعه کنید.
درخواستهای صفحهبندیشده
درخواستهای صفحهبندیشده (برای مثال، درخواستهایی که حاوی یک next_page_token معتبر هستند) جزو سهمیه عملیات روزانه کاربر محسوب نمیشوند. با این حال، درخواستهای صفحهبندی که حاوی یک 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 20000 است. اگر از این حد تجاوز کنید، خطای FILTER_HAS_TOO_MANY_VALUES بازگردانده میشود.