تغییرات آتی در پاسخ‌های Search و SearchStream در Google Ads API

سه‌شنبه، ۱ ژوئیه ۲۰۲۵

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

پارسال، سنجه query_resource_consumption را به‌عنوان روشی برای اندازه‌گیری هزینه پُرسمان Google Ads API معرفی کردیم. اما وقتی نتایج پُرسمان خالی بود، این هزینه برگردانده نمی‌شد.

از هفته ۴ اوت ۲۰۲۵، رفتار هر دو روش Search و SearchStream از GoogleAdsService را در همه نسخه‌های میانای برنامه‌سازی کاربردی تغییر خواهیم داد تا سنجه query_resource_consumption و فیلد field_mask را حتی زمانی که نتایج پُرسمان خالی است برگرداند. پاسخ‌های مربوط به نتایج پُرسمان خالی به‌صورت زیر تغییر خواهد کرد:

روش پاسخ قدیمی پاسخ جدید
جستجو
{
    "fieldMask": "..."
}
{
    "fieldMask": "...",
    "query_resource_consumption": 123
}
SearchStream
[]
{
    "fieldMask": "...",
    "queryResourceConsumption": 206
}

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

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

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

برای هرگونه سؤال مربوط به خط‌مشی‌های حساب، با تیم پشتیبانی محصول Google Ads تماس بگیرید.

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