الإبلاغ عن البث باستخدام GoogleAdsService

لاسترداد كيانات Google Ads API وبيانات إعداد التقارير، يمكنك استخدام إحدى الطرق التالية:

في ما يلي الاختلافات عالية المستوى بين الطريقتين:

GoogleAdsService.SearchStream GoogleAdsService.Search
مناسبة لرمز الإنتاج نعم نعم
الخدمة GoogleAdsService GoogleAdsService
السيناريو جارٍ استرجاع العناصر والتقارير جارٍ استرجاع العناصر والتقارير
الإجابة ساحة مشاركات GoogleAdsRow من العناصر صفحات عناصر GoogleAdsRow
حقول الرد فقط تلك المحددة في طلب البحث فقط تلك المحددة في طلب البحث
الحدود اليومية الحدود اليومية بناءً على مستويات الوصول الحدود اليومية بناءً على مستويات الوصول

يمكن لأداة Search إرسال طلبات مقسّمة على صفحات متعددة لتنزيل التقرير بالكامل، بينما ترسل SearchStream طلبًا واحدًا وتبدأ اتصالاً دائمًا بواجهة Google Ads API بغض النظر عن حجم التقرير.

بالنسبة إلى SearchStream، يبدأ تنزيل حِزم البيانات على الفور مع تخزين النتيجة بالكامل مؤقتًا في المخزن المؤقت للبيانات. يمكن أن تبدأ التعليمة البرمجية في قراءة البيانات المخزنة مؤقتًا دون الحاجة إلى انتظار انتهاء البث بالكامل.

استنادًا إلى إعدادات تطبيقك، يمكن أن يؤدي استخدام SearchStream إلى تحسُّن أداء عملية نقل البيانات، لا سيّما للتقارير الأكبر حجمًا، وذلك من خلال الحدّ من وقت إرسال بيانات الشبكة ذهابًا وإيابًا لطلب كل صفحة فردية من استجابة Search.

مثال

عليك اختيار تقرير يتألف من 100,000 صف مثلاً. يحلل الجدول التالي الاختلافات المحاسبية بين الطريقتين.

SearchStream بحث
حجم الصفحة غير سارية 10000 صف لكل صفحة
عدد طلبات البيانات من واجهة برمجة التطبيقات طلب واحد 10 طلبات
عدد استجابات واجهة برمجة التطبيقات بث واحد متواصل 10 ردود

عوامل الأداء

في معظم حالات الاستخدام، ننصح بـ SearchStream بدلاً من Search للأسباب التالية:

  • بالنسبة إلى تقارير الصفحة الواحدة (أقل من 10,000 صف): لا توجد اختلافات كبيرة في الأداء بين الطريقتين.

  • بالنسبة إلى تقارير الصفحات المتعددة: يكون عادةً SearchStream أسرع بسبب تجنُّب جولات الذهاب والعودة المتعددة، كما أنّ القراءة أو الكتابة من ذاكرة التخزين المؤقت على القرص هي عامل أقل أهمية.

حدود المعدل

تلتزم الحدود اليومية لكلتا الطريقتين بالحدود العادية ومستويات الوصول للرمز المميز للمطوِّر. يتم احتساب طلب بحث أو تقرير واحد كعملية واحدة بغض النظر عن النتيجة التي يتم ترحيلها إلى صفحات أو صفحات.