لاسترداد عناصر Google Ads API وبيانات إعداد التقارير، استخدِم إحدى الطريقتَين أدناه:
في ما يلي الاختلافات الأساسية بين الطريقتَين:
| GoogleAdsService.SearchStream | GoogleAdsService.Search | |
|---|---|---|
| مناسب لرمز الإنتاج | نعم | نعم |
| الخدمة | GoogleAdsService |
GoogleAdsService |
| السيناريو | استرجاع العناصر والتقارير | استرجاع العناصر والتقارير |
| الردّ | بث لكائنات GoogleAdsRow |
صفحات GoogleAdsRow كائن |
| حقول الردّ | الحسابات المحدّدة في طلب البحث فقط | الحسابات المحدّدة في طلب البحث فقط |
| الحدود اليومية | الحدود اليومية استنادًا إلى مستويات الوصول | الحدود اليومية استنادًا إلى مستويات الوصول |
SearchStream مقارنةً بـ Search
في حين أنّ Search يمكنه إرسال عدة requests
مقسّمة حسب الصفحات لتنزيل التقرير بأكمله، يُرسِل SearchStream طلبًا واحدًا ويُبدِئ اتصالاً دائمًا مع Google Ads API بغض النظر عن حجم التقرير.
بالنسبة إلى SearchStream، تبدأ حِزم البيانات بالتنزيل على الفور مع تخزين نتيجة
البحث بالكامل في ذاكرة تخزين مؤقت للبيانات. يمكن أن يبدأ الرمز البرمجي بقراءة البيانات المخزّنة مؤقتًا
بدون الحاجة إلى الانتظار حتى انتهاء البث بالكامل.
من خلال إزالة وقت التنقّل على الشبكة المطلوب لطلب كل صفحة فردية منSearch، استنادًا إلى تطبيقك، يمكن أن يوفّرSearchStream أداءً أفضل من تقسيم الصفحات، خاصةً للتقارير الأكبر حجمًا.
مثال
يتناول هذا المثال تقريرًا يتألّف من 100,000 صف. يوضّح الجدول التالي اختلافات المحاسبة بين الطريقتَين.
| SearchStream | بحث | |
|---|---|---|
| حجم الصفحة | غير سارية | 10,000 صف في كل صفحة |
| عدد طلبات البيانات من واجهة برمجة التطبيقات | طلب واحد | 10 طلبات |
| عدد الردود من واجهة برمجة التطبيقات | بث مباشر واحد | 10 ردود |
عوامل الأداء
في معظم حالات الاستخدام، ننصحك باستخدام SearchStream بدلاً من Search للأسباب التالية:
بالنسبة إلى التقارير التي تتضمّن صفحة واحدة (أقل من 10,000 صف): لا توجد اختلافات مهمة في الأداء بين الطريقتَين.
بالنسبة إلى التقارير التي تتضمّن عدّة صفحات: يكون
SearchStreamعادةً أسرع لأنّه يتم تجنُّب عدة عمليات ذهاب وإياب، كما أنّ القراءة أو الكتابة من ذاكرة التخزين المؤقت على القرص تُعدّ عاملاً أقل أهمية.
حدود معدّل الاستخدام
تلتزم الحدود اليومية لكلتا الطريقتَين بالحدود العادية ومستويات الوصول لرمز مطوِّر تطبيقك. يتم احتساب طلب بحث أو تقرير واحد كعملية واحدة بغض النظر عمّا إذا كانت النتيجة معروضة على صفحات أو يتم بثّها.