توضّح هذه السمة الشروط المسبقة التي لم يتم استيفاؤها.
على سبيل المثال، إذا تعذّر تنفيذ طلب إجراء مكالمة عن بُعد (RPC) لأنّه يتطلّب الموافقة على بنود الخدمة، يمكن أن يدرج رسالة PreconditionFailure انتهاك بنود الخدمة.
| تمثيل JSON |
|---|
{
"violations": [
{
object ( |
| الحقول | |
|---|---|
violations[] |
تصف هذه السمة جميع انتهاكات الشروط المسبقة. |
الانتهاك
نوع رسالة يُستخدَم لوصف تعذُّر استيفاء شرط مسبق واحد.
| تمثيل JSON |
|---|
{ "type": string, "subject": string, "description": string } |
| الحقول | |
|---|---|
type |
نوع PreconditionFailure. ننصحك باستخدام نوع تعداد خاص بالخدمة لتحديد مواضيع انتهاك الشروط المسبقة المتوافقة. على سبيل المثال، "مخالفة بنود الخدمة" |
subject |
الموضوع، بالنسبة إلى النوع، الذي تعذّر تنفيذه. على سبيل المثال، يشير الرابط "google.com/cloud" بالنسبة إلى النوع "بنود الخدمة" إلى بنود الخدمة التي تتم الإشارة إليها. |
description |
وصف لسبب تعذُّر تطبيق الشرط المسبق ويمكن للمطوّرين استخدام هذا الوصف لمعرفة كيفية إصلاح الخطأ. على سبيل المثال: "لم يتم قبول بنود الخدمة". |