Method: approvals.start

شروع تأیید یک فایل. برای اطلاعات بیشتر، به مدیریت تأییدیه‌ها مراجعه کنید.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
fileId

string

الزامی. شناسه فایلی که تأیید روی آن ایجاد شده است.

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "reviewerEmails": [
    string
  ],
  "dueTime": string,
  "lockFile": boolean,
  "message": string
}
فیلدها
reviewerEmails[]

string

الزامی. ایمیل کاربرانی که برای بررسی تأیید تنظیم شده‌اند.

dueTime

string ( Timestamp format)

اختیاری. زمان لازم برای دریافت تأیید.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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

برخی از حوزه‌ها محدود شده‌اند و برای استفاده برنامه شما از آنها، ارزیابی امنیتی لازم است. برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.