במאמר הזה מוסבר איך לנהל אישורים ב-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מהתגובה הקודמת.