Method: approvals.start

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

طلب HTTP

POST https://www.googleapis.com/drive/v3/files/{fileId}/approvals:start

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
fileId

string

الحقل مطلوب. رقم تعريف الملف الذي سيتم إنشاء طلب الموافقة فيه

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل JSON 
{
  "reviewerEmails": [
    string
  ],
  "dueTime": string,
  "lockFile": boolean,
  "message": string
}
الحقول
reviewerEmails[]

string

الحقل مطلوب. عناوين البريد الإلكتروني للمستخدمين الذين تم ضبطهم لمراجعة الموافقة
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".
lockFile

boolean

اختياريّ. تحديد ما إذا كان سيتم قفل الملف عند بدء عملية الموافقة
message

string

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال Approval.

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata

بعض النطاقات محظورة وتتطلّب إجراء تقييم أمان لتتمكّن من استخدامها في تطبيقك. لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.