قیمت‌گذاری، محدودیت‌ها و سهمیه‌های میانای برنامه‌سازی کاربردی

‫Search Ads 360 Reporting API محدودیت‌هایی را بر عملیات میانای برنامه‌سازی کاربردی اعمال می‌کند تا عملکرد بهینه سیستم را برای همه کاربران تضمین کند.

قیمت‌گذاری

استفاده از Search Ads 360 Reporting API در قیمت‌گذاری کلی Search Ads 360 گنجانده شده است. هیچ کارمزد اضافی‌ای برای استفاده از میانای برنامه‌سازی کاربردی وجود ندارد.

حدود پُرسمان

محدودیت‌های زیر برای عملیات پُرسمان انجام‌شده ازطریق روش‌های Search یا SearchStream اعمال می‌شود.

  • ۳۰۰۰ پُرسمان در دقیقه برای هر پروژه برای هر کاربر
  • ۳۰۰۰ پُرسمان در دقیقه برای هر پروژه
  • ‫۱۵۰٬۰۰۰ پُرسمان در روز برای هر پروژه

حدود عملیات روزانه میانای برنامه‌سازی کاربردی

حدود استفاده روزانه از API براساس تعداد عملیات API انجام‌شده در هر پروژه Google Cloud است.

یک پُرسمان یا گزارش به‌عنوان یک عملیات محسوب می‌شود، صرف‌نظر از اینکه نتایج ازطریق SearchAds360Service.SearchStream جاری‌سازی شوند یا ازطریق تماس SearchAds360Service.Search صفحه‌بندی شوند. بیشتر بدانید.

جدول زیر چند نمونه از حسابداری را نشان می‌دهد:

درخواست میانای برنامه‌سازی کاربردی عملیات‌های محاسبه‌شده در حد روزانه
عملیات: Search
تعداد: ۵۳ گروه آگهی
سرویس: SearchAds360Service
1
عملیات: SearchStream
تعداد: ۴۵ پویش
سرویس: SearchAds360Service
1

درخواست‌هایی که این حدود را نقض کنند با این خطا رد می‌شوند: RESOURCE_EXHAUSTED.

درخواست‌های جستجو

درخواست Search یا SearchStream به‌عنوان یک عملیات در سهمیه عملیات روزانه کاربر محسوب می‌شود. یک درخواست SearchStream به‌عنوان یک عملیات API محسوب می‌شود صرف‌نظر از تعداد دسته‌ها.

محدودیت‌های gRPC

همه کتابخانه‌های کارخواه Search Ads 360 Reporting API از gRPC برای تولید درخواست‌ها و پاسخ‌ها استفاده می‌کنند. به‌طور پیش‌فرض، gRPC اندازه پیام ۴ مگابایت دارد.

پاسخ‌ها نباید از این حد فراتر برود. برای مثال، درخواست جستجویی که شامل فیلدهای زیادی باشد ممکن است پاسخی تولید کند که اندازه آن از ۴ مگابایت بیشتر باشد. برای اجتناب از این محدودیت، می‌توانید تعداد فیلدهای انتخاب‌شده را کاهش دهید، اندازه صفحه را کاهش دهید، یا از جاری‌سازی استفاده کنید.

درخواست‌هایی که این محدودیت را نقض کنند، SearchAds360Error تولید نخواهند کرد، بلکه خطای gRPC 429 Resource Exhausted تولید خواهند کرد. به فهرست کدها و پیام‌های خطای gRPC مراجعه کنید.

درخواست‌های صفحه‌بندی‌شده

درخواست‌های صفحه‌بندی‌شده (برای مثال، درخواست‌هایی که حاوی next_page_token معتبر هستند) در سهمیه عملیات روزانه کاربر محاسبه نمی‌شوند. بااین‌حال، درخواست‌های صفحه‌بندی که حاوی کد صفحه منقضی‌شده یا نامعتبر باشند، استثنا ایجاد می‌کنند و در سهمیه عملیات روزانه لحاظ می‌شوند.

درخواست‌های صفحه‌بندی‌شده، مانند درخواست‌های جستجو، نیز مشمول محدودیت Page size cannot exceed 10,000 rows هستند و اگر این محدودیت را نقض کنند، با این خطا رد می‌شوند: INVALID_PAGE_SIZE.

برای جزئیات بیشتر درباره صفحه‌بندی، به صفحه‌بندی نتایج مراجعه کنید.

درخواست‌هایی که استثناهای میانای برنامه‌سازی کاربردی را برمی‌گردانند

درخواست‌هایی که با SearchAds360Failure رد می‌شوند همچنان در سهمیه عملیات روزانه کاربر لحاظ می‌شوند.

درخواست‌هایی که ناموفق هستند اما SearchAds360Failure برنمی‌گردانند، مثلاً به‌دلیل خطایی در سطح شبکه، جزو سهمیه عملیات روزانه کاربر محسوب نمی‌شوند زیرا این درخواست‌ها هرگز به سرویس نمی‌رسند. نمونه‌ای از این مورد، خطای اتصال شبکه است.

انواع دیگر محدودیت‌ها

فیلد تکراری، مثل فهرست عملیات، که موارد زیادی در درخواست دارد می‌تواند باعث بروز این خطا شود: REQUEST_SIZE_LIMIT_EXCEEDED. این پیام خطا ممکن است به‌دلیل مشکلات دیگری نیز باشد.

هنگام ایجاد پُرسمان زبان پُرسمان Search Ads 360، حداکثر تعداد موارد در عبارت IN برابر با ۲۰٬۰۰۰ است. اگر از این حد فراتر بروید، خطای FILTER_HAS_TOO_MANY_VALUES برگردانده می‌شود.