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