این سند نحوه مدیریت تأییدیهها در API گوگل درایو را توضیح میدهد.
میتوانید تأییدیههای محتوای خود را در گوگل درایو پیدا کنید. رابط برنامهنویسی کاربردی گوگل درایو منبع approvals را فراهم میکند تا بتوانید وضعیت تأییدیههای خود را دریافت و فهرست کنید. روشهای منبع approvals روی موارد موجود در درایو، گوگل داکز و سایر ویرایشگرهای گوگل ورکاسپیس کار میکنند.
شما میتوانید از این فرآیند برای یافتن تاییدیهها در موقعیتهای بررسی رسمی، مانند بررسی قرارداد یا یک سند رسمی قبل از انتشار، استفاده کنید. تاییدیه، وضعیت بررسی (مانند در حال انجام، تایید شده یا رد شده) و همچنین وضعیت بررسیکنندگان مربوطه را پیگیری میکند. تاییدیهها راهی عالی برای اعتبارسنجی محتوا و ثبت سوابق بررسیکنندگان هستند.
برای مشاهدهی مجوزهای یک فایل، باید مجوز خواندن فرادادههای آن فایل را داشته باشید. برای اطلاعات بیشتر، به بخش نقشها و مجوزها مراجعه کنید.
استفاده از پارامتر فیلدها
اگر میخواهید فیلدهایی را که باید در پاسخ برگردانده شوند، مشخص کنید، میتوانید پارامتر سیستمی fields را با هر متدی از منبع approvals تنظیم کنید. اگر پارامتر fields را حذف کنید، سرور مجموعهای پیشفرض از فیلدهای خاص متد را برمیگرداند. برای برگرداندن فیلدهای مختلف، به بخش Return specific fields مراجعه کنید.
دریافت تاییدیه
برای دریافت تاییدیه روی یک فایل، از متد get روی منبع approvals به همراه پارامترهای مسیر fileId و approvalId استفاده کنید. اگر شناسه تاییدیه را نمیدانید، میتوانید با استفاده از متد list ، تاییدیهها را فهرست کنید .
بدنه پاسخ شامل نمونهای از منبع approvals است.
فهرست تاییدیهها
برای فهرست کردن تاییدیهها در یک فایل، متد list را در منبع approvals فراخوانی کنید و پارامتر مسیر fileId را نیز به آن اضافه کنید.
بدنه پاسخ شامل فهرستی از مصوبات موجود در پرونده است. فیلد items شامل اطلاعات مربوط به هر مصوبه در قالب منبع approvals است.
منبع approvals همچنین شامل یک شیء Status است که وضعیت تأیید را شرح میدهد، و همچنین شیء ReviewerResponse که جزئیات پاسخ به تأیید انجام شده توسط یک بررسیکننده خاص را شرح میدهد. پاسخ این بررسیکننده توسط شیء Response نمایش داده میشود.
همچنین میتوانید پارامترهای کوئری زیر را برای سفارشیسازی صفحهبندی یا فیلتر کردن تاییدیهها ارسال کنید:
pageSize: حداکثر تعداد تاییدیههایی که باید به ازای هر صفحه برگردانده شود. اگرpageSizeتنظیم نکنید، سرور تا ۱۰۰ تاییدیه برمیگرداند.pageToken: یک توکن صفحه که از فراخوانی لیست قبلی دریافت شده است. این توکن برای بازیابی صفحه بعدی استفاده میشود. باید روی مقدارnextPageTokenاز پاسخ قبلی تنظیم شود.