במאמר הזה מוסבר איך לנהל אישורים ב-Google Drive API.
אפשר למצוא את אישורי התוכן ב-Google Drive. Google Drive API מספק את המשאב approvals כדי שתוכלו לקבל את סטטוס האישורים שלכם ולראות רשימה שלהם. השיטות של משאב approvals פועלות על פריטים ב-Drive, ב-Google Docs ובעורכים אחרים של Google Workspace.
אתם יכולים להשתמש בתהליך הזה כדי לאתר אישורים במצבים של בדיקה רשמית, כמו בדיקת חוזה או מסמך רשמי לפני פרסום. תהליך אישור כולל מעקב אחרי הסטטוס של הבדיקה (למשל, בבדיקה, אושר או נדחה) ואחרי הבודקים המעורבים. אישורים הם דרך מצוינת לאמת תוכן ולשמור תיעוד של הבודקים.
כדי לראות את האישורים של קובץ, צריך הרשאת קריאה של המטא-נתונים של הקובץ. מידע נוסף זמין במאמר בנושא תפקידים והרשאות.
שימוש בפרמטר fields
אם רוצים לציין את השדות שיוחזרו בתגובה, אפשר להגדיר את fields פרמטר המערכת approvals בכל שיטה של המשאב. אם משמיטים את הפרמטר fields, השרת מחזיר קבוצת ברירת מחדל של שדות שספציפיים לשיטה. כדי להחזיר שדות שונים, אפשר לעיין במאמר החזרת שדות ספציפיים.
קבלת אישור
כדי לקבל אישור על קובץ, משתמשים בשיטה get במשאב approvals עם פרמטרי הנתיב fileId ו-approvalId. אם אתם לא יודעים את מזהה האישור, אתם יכולים לרשום את האישורים באמצעות method list.
גוף התשובה מכיל מופע של משאב approvals.
הצגת רשימת אישורים
כדי להציג רשימה של אישורים בקובץ, צריך להפעיל את ה-method list במשאב approvals ולכלול את פרמטר הנתיב fileId.
גוף התשובה כולל רשימה של אישורים בקובץ. השדה
items
כולל מידע על כל אישור בצורה של משאב approvals.
במשאב approvals יש גם אובייקט Status שמפרט את סטטוס האישור, ואובייקט ReviewerResponse שמפרט את התגובה לאישור שניתן על ידי בודק ספציפי. התגובה של הבודק הזה מיוצגת על ידי האובייקט Response.
אפשר גם להעביר את פרמטרים השאילתה הבאים כדי להתאים אישית את המספור של הדפים או לסנן את האישורים:
pageSize: מספר האישורים המקסימלי שיוחזר בכל דף. אם לא מגדירים אתpageSize, השרת מחזיר עד 100 אישורים.
pageToken: טוקן של דף שהתקבל מקריאה קודמת של רשימה. הטוקן הזה משמש לאחזור הדף הבא. צריך להגדיר אותו לערך שלnextPageTokenמהתגובה הקודמת.