الأدلة

الأخطاء

للأخطاء بنية واحدة ورموز ثابتة المعنى. استخدم الرمز لتحديد مسار برنامجك، واعرض الرسالة للمستخدم.

409 — تعارض

{
  "error": {
    "code": "conflict",
    "message": "This campaign is already sending"
  }
}

تذكر الرسالة اسم الحقل إذا كانت المدخلات غير صحيحة، وتوضّح ما يلزم فعله إذا منعت قاعدةٌ الإجراء. تعيد أدوات MCP الكائن نفسه ضمن نتيجة خطأ. إرسال حملة يجري إرسالها أو أُرسلت بالفعل يعيد conflict، لذلك لا تؤدي إعادة محاولة الإرسال إلى إرسال الحملة مرتين.

الرمز	الحالة	المعنى
`unauthorized` مفتاح API مفقود أو غير صالح أو غير معروف أو ملغى.	401	مفتاح API مفقود أو غير صالح أو غير معروف أو ملغى.
`forbidden` مستوى المفتاح لا يسمح بهذا الإجراء: مفتاح الاشتراكات فقط يمكنه إضافة جهات اتصال فقط.	403	مستوى المفتاح لا يسمح بهذا الإجراء: مفتاح الاشتراكات فقط يمكنه إضافة جهات اتصال فقط.
`not_found` النشرة أو الحملة أو الكاتب أو جهة الاتصال أو الشريحة أو النطاق أو المفتاح غير موجود في هذا الحساب.	404	النشرة أو الحملة أو الكاتب أو جهة الاتصال أو الشريحة أو النطاق أو المفتاح غير موجود في هذا الحساب.
`validation_failed` المدخلات لا تطابق المخطط أو تخالف إحدى القواعد. توضح الرسالة اسم الحقل.	400	المدخلات لا تطابق المخطط أو تخالف إحدى القواعد. توضح الرسالة اسم الحقل.
`conflict` حالة المورد لا تسمح بالإجراء، مثل إرسال حملة يجري إرسالها أو أُرسلت بالفعل. إعادة المحاولة لا تحل المشكلة.	409	حالة المورد لا تسمح بالإجراء، مثل إرسال حملة يجري إرسالها أو أُرسلت بالفعل. إعادة المحاولة لا تحل المشكلة.
`revision_conflict` تغيّرت المسودة منذ المراجعة المرسلة مع update_campaign. اجلب النسخة الجديدة عبر get_campaign وابدأ منها.	409	تغيّرت المسودة منذ المراجعة المرسلة مع update_campaign. اجلب النسخة الجديدة عبر get_campaign وابدأ منها.
`rate_limited` تجاوز المفتاح حد الطلبات، أو تجاوز الحساب حد إجراء معيّن. تتشارك مفاتيحه وتطبيقاته ولوحة التحكم حدود الحساب. انتظر ثم أعد المحاولة.	429	تجاوز المفتاح حد الطلبات، أو تجاوز الحساب حد إجراء معيّن. تتشارك مفاتيحه وتطبيقاته ولوحة التحكم حدود الحساب. انتظر ثم أعد المحاولة.
`subscription_required` لا توجد خطة نشطة للحساب.	402	لا توجد خطة نشطة للحساب.
`billing_off` الخادم مستضاف ذاتيًا بلا فوترة: يحصل كل حساب على جميع الميزات دون حدود الخطط.	404	الخادم مستضاف ذاتيًا بلا فوترة: يحصل كل حساب على جميع الميزات دون حدود الخطط.
`plan_limit_emails` يتطلب الإرسال رسائل أكثر من المتبقي في الخطة لهذا الشهر.	402	يتطلب الإرسال رسائل أكثر من المتبقي في الخطة لهذا الشهر.
`plan_limit_subscribers` عدد المشتركين النشطين في الحساب يتجاوز حد خطته.	402	عدد المشتركين النشطين في الحساب يتجاوز حد خطته.
`account_blocked` الحساب محظور بسبب مؤشرات البريد المزعج، مثل الارتدادات أو الشكاوى أو معدل Gmail في Google Postmaster Tools أو عنوان مصيدة أو مزوّد البريد، أو بقرار مشرف. يتوقف الإرسال وإعادة توجيه الروابط المتتبعة. تبقى القراءة والإيقاف وإلغاء الجدولة وإلغاء الوصول وبوابة الفوترة متاحة حتى يرفع المشرف الحظر. في نظام الفوترة القديم تبقى الخطة نشطة دون تحصيل، ولا يمكن تغييرها أثناء الحظر.	403	الحساب محظور بسبب مؤشرات البريد المزعج، مثل الارتدادات أو الشكاوى أو معدل Gmail في Google Postmaster Tools أو عنوان مصيدة أو مزوّد البريد، أو بقرار مشرف. يتوقف الإرسال وإعادة توجيه الروابط المتتبعة. تبقى القراءة والإيقاف وإلغاء الجدولة وإلغاء الوصول وبوابة الفوترة متاحة حتى يرفع المشرف الحظر. في نظام الفوترة القديم تبقى الخطة نشطة دون تحصيل، ولا يمكن تغييرها أثناء الحظر.
`sender_not_allowed` عنوان from ليس عنوان النشرة المشترك ولا ينتمي إلى نطاق موثّق في هذا الحساب.	422	عنوان from ليس عنوان النشرة المشترك ولا ينتمي إلى نطاق موثّق في هذا الحساب.
`send_check_failed` فشل فحص قبل الإرسال: لا يوجد عنوان بريدي أو عنوان رسالة أو محتوى أو كاتب، أو يتجاوز حجم الرسالة 100 KB، أو حُذفت شريحتها.	422	فشل فحص قبل الإرسال: لا يوجد عنوان بريدي أو عنوان رسالة أو محتوى أو كاتب، أو يتجاوز حجم الرسالة 100 KB، أو حُذفت شريحتها.
`no_recipients` لا يوجد مستلمون متبقون للإرسال إليهم.	422	لا يوجد مستلمون متبقون للإرسال إليهم.
`sending_disabled` الإرسال معطّل على هذا الخادم.	503	الإرسال معطّل على هذا الخادم.
`unavailable` إحدى الخدمات التي يحتاجها الإجراء غير مهيأة أو لم تستجب. أعد المحاولة لاحقًا.	503	إحدى الخدمات التي يحتاجها الإجراء غير مهيأة أو لم تستجب. أعد المحاولة لاحقًا.
`internal_error` حدث خطأ من جهة سطر.	500	حدث خطأ من جهة سطر.