به‌روزرسانی خط‌مشی استفاده از منابع Google Ads API

چهارشنبه، ۱ مه ۲۰۲۴

چه چیزی تغییر می‌کند؟

درحال به‌روزرسانی خط‌مشی استفاده از منابع Google Ads API هستیم تا الگوهای پُرسمان GoogleAdsService.Search و GoogleAdsService.SearchStream را که مقدار زیادی از منابع API را مصرف می‌کنند محدود کنیم. اگر الگوی پُرسمان خاصی محدود شود، سایر سرویس‌ها، روش‌ها، و الگوهای پُرسمان بدون تأثیر به کار خود ادامه خواهند داد.

از هفته ۱۷ ژوئن ۲۰۲۴، و فقط برای الگوهای پُرسمان محدودشده، درخواست‌ها به‌صورت زیر تحت‌تأثیر قرار خواهند گرفت:

  • اگر از نسخه v17 یا قدیمی‌تر API استفاده می‌کنید، خطای QuotaError.RESOURCE_EXHAUSTED را دریافت خواهید کرد.
  • اگر از نسخه v18 یا جدیدتر API استفاده می‌کنید، بسته به اینکه مصرف بیش‌ازحد منابع برای مدت کوتاهی (چند دقیقه) بوده است یا مدت طولانی، QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION یا QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION دریافت خواهید کرد.

برای کمک به شما در شناسایی و نظارت بر گزارش‌های پرهزینه، سنجه هزینه را نیز برای گزارش‌های تکی برمی‌گردانیم. برای مشاهده هزینه گزارش‌های موفق، فیلدهای زیر را ببینید:

چرا این تغییر؟

این تغییر را برای حفظ قابلیت اطمینان و پایداری میانای برنامه‌سازی کاربردی ایجاد می‌کنیم.

چه کاری باید انجام دهم؟

پیش‌از ۱۷ ژوئن ۲۰۲۴، برنامه‌هایتان را به‌روز کنید تا کارهای زیر را انجام دهند:

  • رسیدگی به کدهای خطای جدید هنگام برقراری تماس‌های GoogleAdsService::Search or GoogleAdsService::SearchStream
    • اگر از نسخه ۱۷ یا قدیمی‌تر Google Ads API استفاده می‌کنید، خطاهای QuotaError.RESOURCE_EXHAUSTED را مدیریت کنید.
    • اگر از نسخه v18 یا جدیدتر API استفاده می‌کنید، خطاهای QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION و QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION را مدیریت کنید.
  • اگر یک یا چند الگوی پرسمان گزارش‌دهی شما محدود شده است، باید الگوی پرسمان را بررسی و اصلاح کنید. در اینجا چند روش برای بهبود عملکرد پُرسمان ارائه شده است:
    • پُرسمان را کمتر اجرا کنید.
    • از الگو یا نمای پُرسمان کم‌هزینه‌تری استفاده کنید.

برای کسب اطلاعات بیشتر درباره بهینه‌سازی پُرسمان‌ها، به مدیریت کارایی داده مراجعه کنید.

  • [اختیاری] سنجه جدید query_resource_consumption را در سیستم‌های نظارتی خود بگنجانید تا پُرسمان‌های گران جدید را شناسایی و مدیریت کنید.

نحوه دریافت کمک

اگر درباره این تغییر سؤالی دارید یا برای بهینه‌سازی الگوهای پُرسمان خاصی به کمک نیاز دارید، گزینه‌های موجود در صفحه پشتیبانی Google Ads API را بررسی کنید.

- دیوید استیونز، مدیر محصول Google Ads API

برچسب‌ها: google-ads-api