REST Resource: approvals

المورد: الموافقة

البيانات الوصفية للموافقة الموافقة هي عملية مراجعة أو موافقة على ملف في 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)
    }
  ],
  "fileContentChangeBehavior": enum (FileContentChangeBehavior)
}
الحقول
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)

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

enum (FileContentChangeBehavior)

سلوك الموافقة عند تغيير محتوى الملف

الحالة

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

عمليات التعداد
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 رفض المراجع العنصر.

FileContentChangeBehavior

سلوك الموافقة عند تغيير محتوى الملف أثناء Status الموافقة IN_PROGRESS. لا يحدث هذا السلوك بعد اكتمال الموافقة.

عمليات التعداد
FILE_CONTENT_CHANGE_BEHAVIOR_UNSPECIFIED لم يتم تحديد السلوك.
RESET_APPROVAL ستتم إعادة ضبط أي ReviewerResponse يتضمّن Response من APPROVED إلى NO_DECISION عندما يتغيّر محتوى الملف بينما يتضمّن طلب الموافقة Status من IN_PROGRESS. عندما تكون الموافقة على Status من APPROVED ويتم اختيار RESET_APPROVAL، يتم قفل الملف.
NO_APPROVAL_ACTION لا يتم اتخاذ أي إجراء عند تغيير محتوى الملف.

الطُرق

approve

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

cancel

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

comment

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

decline

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

get

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

list

 يسرد الموافقات على ملف.

reassign

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

start

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