گزارش جریان با استفاده از GoogleAdsService

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

• GoogleAdsService.SearchStream
• GoogleAdsService.Search

در اینجا تفاوت‌های سطح بالای این دو روش آورده شده است:

SearchStream در مقابل Search

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

برای SearchStream ، بسته‌های داده بلافاصله شروع به دانلود می‌کنند و کل نتیجه در یک بافر داده ذخیره می‌شود. کد شما می‌تواند بدون نیاز به انتظار برای اتمام کل جریان، شروع به خواندن داده‌های بافر شده کند.

با حذف زمان رفت و برگشت شبکه مورد نیاز برای درخواست هر صفحه جداگانه از پاسخ Search ، بسته به برنامه شما، SearchStream می‌تواند عملکرد بهبود یافته‌ای را نسبت به صفحه‌بندی، به ویژه برای گزارش‌های بزرگتر، ارائه دهد.

مثال

این مثال به گزارشی می‌پردازد که شامل 100,000 ردیف است. جدول زیر تفاوت‌های حسابداری بین دو روش را نشان می‌دهد.

عوامل عملکرد

در بیشتر موارد استفاده، به دلایل زیر SearchStream به Search ترجیح می‌دهیم:

• برای گزارش‌های تک‌صفحه‌ای (کمتر از ۱۰۰۰۰ سطر): هیچ تفاوت عملکردی قابل توجهی بین دو روش وجود ندارد.

• برای گزارش‌های چند صفحه‌ای: SearchStream معمولاً سریع‌تر است زیرا از چندین رفت و برگشت اجتناب می‌شود و خواندن یا نوشتن از حافظه پنهان دیسک اهمیت کمتری دارد.

محدودیت‌های نرخ

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