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,
  "fileContentChangeBehavior": enum (FileContentChangeBehavior)
}
الحقول
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

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

enum (FileContentChangeBehavior)

اختياريّ. سلوك طلب الموافقة عند تغيير محتوى الملف

نص الاستجابة

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

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

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

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

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