الـ automation الناجح لا يقاس بسرعة الإرسال فقط؛ يقاس بقدرته على احترام limits والتعافي.

نُشر في 12 أغسطس 2026 · Google Ads API / Quotas / Mutate Requests / PMax

توثيق Google Ads API يوضح أن الاستخدام اليومي يعتمد على عدد get requests وmutate operations لكل developer token، وأن mutate request لا يمكن أن يحتوي أكثر من 10,000 عملية، مع حدود خاصة لبعض الخدمات مثل Planning وConversion Upload وAudience Insights. لذلك تعديل واسع على PMax أو Demand Gen ليس مجرد loop؛ هو عملية تشغيل تحتاج rate plan وqueue وrollback.

المشكلة في الوكالات

عندما تدير عشرات الحسابات، قد يمر سكريبت بسيط على كل حملة وأصل وموقع. أول تشغيل يبدو ناجحًا، لكن مع نمو الحسابات يبدأ النظام في أخطاء quota أو gRPC size أو TOO_MANY_MUTATE_OPERATIONS. الخطر الأكبر أن يعيد السكريبت المحاولة بالطريقة نفسها فيستهلك عمليات أكثر.

في Performance Max تحديدًا، تحديث الأصول أو الإشارات أو التجارب قد يلمس أجزاء كثيرة. ومع تغييرات v25 مثل asset automation والتقارير الجديدة، يصبح ربط كل mutate بسجل campaign وjob id ضروريًا لفهم الأداء لاحقًا.

طريقة أكثر أمانًا

قسّم العمل حسب الحساب والحملة ونوع العملية. اجعل كل batch صغيرًا بما يكفي للمتابعة، وسجّل قبل وبعد: resource name، العملية، النتيجة، والخطأ إن وجد. SearchStream مفيد للتقارير الكبيرة، لكن اختيار fields زائد قد يصطدم بحد حجم response، لذلك التقرير نفسه يحتاج تصميمًا.

الأخطاء التي ترجع من API ليست كلها متساوية. RESOURCE_EXHAUSTED يعني توقفًا منظمًا وإعادة جدولة، وليس retry سريع. أما فشل network قبل وصول الطلب فلا يحسب بالطريقة نفسها، لكنه يحتاج idempotency في منطقك حتى لا تطبق نفس التعديل مرتين.

Checklist

• احسب عدد get وmutate operations قبل التشغيل.
• قسّم mutate jobs إلى دفعات قابلة للمراجعة.
• تعامل مع RESOURCE_EXHAUSTED كتأجيل لا كإعادة فورية.
• قلل fields في التقارير الكبيرة أو استخدم streaming.
• سجل نتيجة كل resource name بعد التعديل.
• اختبر على حساب test قبل الإنتاج.

أين تدخل ok4host؟

ok4host يراجع سكريبتات Google Ads API ولوحات PMax حتى تكون حدود quota، retry، وسجل التغيير جزءًا من التصميم وليس إضافة بعد التعطل.

أسئلة شائعة

هل 10,000 عملية تعني أن أرسل الحد الأقصى دائمًا؟ لا؛ الأفضل دفعات أصغر قابلة للقياس والرجوع.

هل SearchStream يحل كل مشاكل التقارير؟ يساعد، لكن اختيار fields كثير قد يسبب response كبيرًا.

ما أول تحسين؟ سجل operations المتوقع قبل تشغيل أي batch.

المصادر

• Google Ads API: API Limits and Quotas.
• Google Ads API: release notes.
• Google Ads API: Performance Max overview.