یک تأیید را لغو میکند. Status تأیید را به CANCELLED بهروزرسانی میکند.
این میتواند توسط هر کاربری که مجوز writer روی فایل را دارد، در حالی که Status تأیید IN_PROGRESS است، فراخوانی شود.
درخواست HTTP
POST https://www.googleapis.com/drive/v3/files/{fileId}/approvals/{approvalId}:cancel
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
fileId | الزامی. شناسه فایلی که تاییدیه روی آن قرار دارد. |
approvalId | الزامی. شناسهی تأییدیه برای لغو. |
درخواست بدنه
بدنه درخواست شامل دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{ "message": string } |
| فیلدها | |
|---|---|
message | اختیاری. پیامی برای همراهی با لغو تأیید. این پیام در اعلانهای مربوط به اقدام و در گزارش فعالیت تأیید درج خواهد شد. |
بدنه پاسخ
در صورت موفقیت، بدنه پاسخ حاوی نمونهای از Approval است.
دامنههای مجوز
به یکی از حوزههای OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/drive -
https://www.googleapis.com/auth/drive.file -
https://www.googleapis.com/auth/drive.metadata
برخی از حوزهها محدود شدهاند و برای استفاده برنامه شما از آنها، ارزیابی امنیتی لازم است. برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.