برای بازیابی موجودیت‌های Google Ads API و داده‌های گزارش، می‌توانید از یکی از این روش‌ها استفاده کنید:
در اینجا تمایزات سطح بالا برای این دو روش وجود دارد:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| مناسب برای کد تولید | آره | آره |
| سرویس | GoogleAdsService | GoogleAdsService |
| سناریو | واکشی اشیا و گزارش ها | واکشی اشیا و گزارش ها |
| واکنش | جریان اشیاء GoogleAdsRow | صفحات اشیاء GoogleAdsRow |
| فیلدهای پاسخ | فقط آنهایی که در پرس و جو مشخص شده اند | فقط آنهایی که در پرس و جو مشخص شده اند |
| محدودیت های روزانه | محدودیت های روزانه بر اساس سطوح دسترسی | محدودیت های روزانه بر اساس سطوح دسترسی |
SearchStream در مقابل جستجو
در حالی که Search می‌تواند چندین درخواست صفحه‌بندی شده برای دانلود کل گزارش ارسال کند، SearchStream یک درخواست را ارسال می‌کند و بدون در نظر گرفتن اندازه گزارش، اتصال دائمی با Google Ads API را آغاز می‌کند.
برای SearchStream ، بسته‌های داده بلافاصله شروع به دانلود می‌کنند و کل نتیجه در یک بافر داده ذخیره می‌شود. کد شما می‌تواند شروع به خواندن داده‌های بافر کند بدون اینکه منتظر بمانید تا کل جریان به پایان برسد.
با حذف زمان رفت و برگشت شبکه مورد نیاز برای درخواست هر صفحه جداگانه از یک پاسخ Search ، بسته به برنامه شما، SearchStream می‌تواند عملکرد بهتری را نسبت به صفحه‌بندی، به ویژه برای گزارش‌های بزرگ‌تر، ارائه دهد.
مثال
به عنوان مثال گزارشی از 100,000 ردیف در نظر بگیرید. جدول زیر تفاوت های حسابداری بین این دو روش را نشان می دهد.
| SearchStream | جستجو کردن | |
|---|---|---|
| اندازه صفحه | قابل اجرا نیست | 10000 ردیف در هر صفحه |
| تعداد درخواست های API | 1 درخواست | 10 درخواست |
| تعداد پاسخ های API | 1 جریان پیوسته | 10 پاسخ |
عوامل عملکرد
برای بیشتر موارد استفاده، به دلایل زیر SearchStream از طریق Search توصیه می کنیم:
برای گزارش های تک صفحه ای (زیر 10000 ردیف): تفاوت عملکرد قابل توجهی بین دو روش وجود ندارد.
برای گزارش‌های چند صفحه:
SearchStreamمعمولاً سریع‌تر است، زیرا از چندین بار رفت و برگشت اجتناب می‌شود و خواندن یا نوشتن از حافظه پنهان دیسک عامل کمتری است.
محدودیت های نرخ
محدودیت‌های روزانه برای هر دو روش از محدودیت‌های استاندارد و سطوح دسترسی توکن توسعه‌دهنده شما تبعیت می‌کنند. یک پرس و جو یا گزارش به عنوان یک عملیات بدون در نظر گرفتن نتیجه صفحه یا پخش جریانی حساب می شود.