Package google.longrunning

الفهرس

العملية

يمثل هذا المورد عملية طويلة المدى ناتجة عن طلب بيانات من واجهة برمجة تطبيقات الشبكة.

الحقول
name

string

الاسم الذي ضبطه الخادم، والذي يكون فريدًا فقط ضمن الخدمة نفسها التي تم عرضه في الأصل في حال استخدام تعيين HTTP التلقائي، يجب أن يكون name اسم مورد ينتهي بـ operations/{unique_id}.

metadata

Any

البيانات الوصفية الخاصة بالخدمة المرتبطة بالعملية. عادة ما يحتوي على معلومات التقدم والبيانات الوصفية الشائعة مثل وقت الإنشاء. قد لا توفّر بعض الخدمات هذه البيانات الوصفية. يجب أن توثّق أي طريقة تُرجع عملية طويلة المدى نوع البيانات الوصفية، إن وجد.

done

bool

إذا كانت القيمة false، يعني ذلك أنّ العملية لا تزال قيد التنفيذ. إذا true، تكتمل العملية، ويكون error أو response متاحًا.

حقل الاتحاد result نتيجة العملية، والتي قد تكون error أو response صالحة. إذا كانت done == false، لن يتم ضبط error أو response. إذا كانت done == true، يمكن ضبط قيمة واحدة من error أو response بالضبط. قد لا تعرض بعض الخدمات النتيجة. يمكن أن تكون السمة "result" واحدة فقط مما يلي:
error

Status

نتيجة الخطأ للعملية في حال تعذّر تنفيذها أو إلغائها.

response

Any

الاستجابة العادية والناجحة للعملية. إذا لم تعرض الطريقة الأصلية أي بيانات عن النجاح، مثل Delete، يكون الرد هو google.protobuf.Empty. إذا كانت الطريقة الأصلية هي Get/Create/Update، يجب أن تكون الاستجابة هي المورد. بالنسبة إلى الطرق الأخرى، يجب أن يكون الردّ من النوع XxxResponse، حيث يكون Xxx هو اسم الطريقة الأصلية. على سبيل المثال، إذا كان اسم الطريقة الأصلية هو TakeSnapshot()، يكون نوع الاستجابة المستنتَج هو TakeSnapshotResponse.