REST Resource: approvals

المورد: Approval

البيانات الوصفية لطلب الموافقة طلب الموافقة هو عملية مراجعة أو موافقة على ملف في Drive.

تمثيل JSON 
{
  "kind": string,
  "approvalId": string,
  "targetFileId": string,
  "createTime": string,
  "modifyTime": string,
  "completeTime": string,
  "dueTime": string,
  "status": enum (Status),
  "initiator": {
    object (User)
  },
  "reviewerResponses": [
    {
      object (ReviewerResponse)
    }
  ]
}
الحقول
kind

string

تكون هذه القيمة دائمًا drive#approval.
approvalId

string

رقم تعريف طلب الموافقة
targetFileId

string

رقم تعريف الملف المستهدَف لطلب الموافقة
createTime

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه إنشاء طلب الموافقة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
modifyTime

string (Timestamp format)

النتائج فقط. آخر وقت تم فيه تعديل طلب الموافقة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
completeTime

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه إكمال طلب الموافقة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
dueTime

string (Timestamp format)

الوقت الذي يجب فيه إكمال طلب الموافقة

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
status

enum (Status)

النتائج فقط. حالة طلب الموافقة في الوقت الذي تم فيه طلب هذا المورد
initiator

object (User)

المستخدم الذي طلب الموافقة
reviewerResponses[]

object (ReviewerResponse)

الردود التي قدّمها المراجعون على طلب الموافقة

الحالة

الحالات المحتملة لطلب الموافقة

عمليات التعداد
STATUS_UNSPECIFIED لم يتم ضبط حالة الموافقة أو تم ضبطها على قيمة غير صالحة.
IN_PROGRESS بدأت عملية الموافقة ولم تكتمل بعد.
APPROVED اكتملت عملية الموافقة وتمت الموافقة على الملف المستهدَف.
CANCELLED تم إلغاء عملية الموافقة قبل اكتمالها.
DECLINED اكتملت عملية الموافقة وتم رفض الملف المستهدَف.

ReviewerResponse

ردّ على طلب موافقة قدّمه مراجع معيّن

تمثيل JSON 
{
  "kind": string,
  "reviewer": {
    object (User)
  },
  "response": enum (Response)
}
الحقول
kind

string

تكون هذه القيمة دائمًا drive#reviewerResponse.
reviewer

object (User)

المستخدم المسؤول عن هذا الردّ
response

enum (Response)

ردّ المراجع على طلب الموافقة

الردّ

الردود المحتملة على طلب الموافقة

عمليات التعداد
RESPONSE_UNSPECIFIED تم ضبط الردّ على قيمة غير معروفة.
NO_RESPONSE لم يُرسِل المراجع ردًّا.
APPROVED وافق المراجع على الملف.
DECLINED رفض المراجع الملف.

الطُرق

approve

 الموافقة على طلب موافقة

cancel

 إلغاء طلب موافقة

comment

 التعليق على طلب موافقة

decline

 رفض طلب موافقة

get

 الحصول على طلب موافقة حسب رقم التعريف

list

 عرض قائمة بطلبات الموافقة على ملف

reassign

 إعادة تعيين المراجعين في طلب موافقة

start

 بدء طلب موافقة على ملف