الإبلاغ عن البث

هناك ثلاث طرق لاسترداد الكيانات وبيانات إعداد التقارير باستخدام Google Ads API.

يركّز هذا الدليل بشكل أساسي على بيانات البث من GoogleAdsService. فيما يلي الاختلافات عالية المستوى لطرق استرجاع البيانات الثلاث:

GoogleAdsService.SearchStream GoogleAdsService.Search طلبات GET
مناسبة لرمز الإنتاج نعم نعم لا (لتصحيح الأخطاء فقط)
خدمة GoogleAdsService GoogleAdsService الخدمات المتعلقة بالموارد (على سبيل المثال، CampaignService)
السيناريو استرجاع العناصر والتقارير استرجاع العناصر والتقارير جارٍ استرجاع العناصر
الإجابة ساحة المشاركات لـ GoogleAdsRow من العناصر صفحات العناصر GoogleAdsRow عنصر واحد (على سبيل المثال، Campaign)
حقول الردّ فقط تلك المحددة في طلب البحث فقط تلك المحددة في طلب البحث تمت تعبئة جميع الحقول.
الحدود اليومية تستند الحدود اليومية إلى مستويات الوصول. تستند الحدود اليومية إلى مستويات الوصول. 1,000 طلب في اليوم

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

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

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

مثال

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

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

عوامل الأداء

وبشكل عام، ننصح باستخدام SearchStream بدلاً من Search للأسباب التالية.

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

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

حدود المعدَّل

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