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

سلوك الموافقة عندما يتغيّر محتوى الملف بينما تكون [الحالة][] هي 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

 يبدأ عملية الموافقة على ملف.