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