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