قیمت‌گذاری، محدودیت‌های API و سهمیه‌ها

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

قیمت گذاری

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

محدودیت های پرس و جو

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

• 3000 پرس و جو در دقیقه در هر پروژه به ازای هر کاربر
• 3000 پرس و جو در دقیقه در هر پروژه
• 150000 درخواست در روز در هر پروژه

محدودیت های عملیاتی روزانه API

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

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

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

درخواست API	عملیات در حد روزانه محاسبه می شود
عملیات: Search تعداد: 53 گروه تبلیغاتی خدمات: SearchAds360Service	1
عملیات: SearchStream تعداد: 45 کمپین خدمات: SearchAds360Service	1

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

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

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

محدودیت های gRPC

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

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

درخواست‌هایی که این محدودیت را نقض می‌کنند، یک 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 20000 است. اگر از این حد تجاوز کنید، یک خطای FILTER_HAS_TOO_MANY_VALUES برگردانده می شود.