Method: approvals.cancel

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

Status تأیید را به CANCELLED به‌روزرسانی می‌کند. این می‌تواند توسط هر کاربری که مجوز writer روی فایل را دارد، در حالی که Status تأیید IN_PROGRESS است، فراخوانی شود.

درخواست HTTP

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

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

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

پارامترها
fileId

string

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

approvalId

string

الزامی. شناسه‌ی مجوز لغو.

درخواست بدنه

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

نمایش JSON 
{
  "message": string
}
فیلدها
message

string

اختیاری. پیامی برای همراهی با لغو تأیید. این پیام در اعلان‌های مربوط به اقدام و در گزارش فعالیت تأیید درج می‌شود.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ حاوی نمونه‌ای از Approval است.

دامنه‌های مجوز

به یکی از حوزه‌های OAuth زیر نیاز دارد:

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

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