REST Resource: approvals

משאב: אישור

מטא-נתונים של אישור. אישור הוא תהליך בדיקה או אישור של פריט ב-Drive.

ייצוג ב-JSON 
{
  "kind": string,
  "approvalId": string,
  "targetFileId": string,
  "createTime": string,
  "modifyTime": string,
  "completeTime": string,
  "dueTime": string,
  "status": enum (Status),
  "initiator": {
    object (User)
  },
  "reviewerResponses": [
    {
      object (ReviewerResponse)
    }
  ],
  "fileContentChangeBehavior": enum (FileContentChangeBehavior)
}
שדות
kind

string

הערך הזה הוא תמיד drive#approval.
approvalId

string

מזהה האישור.
targetFileId

string

מזהה קובץ היעד של האישור.
createTime

string (Timestamp format)

השעה שבה נוצרה בקשת האישור.

השימוש הוא ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
modifyTime

string (Timestamp format)

הפעם האחרונה שבה האישור שונה.

השימוש הוא ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
completeTime

string (Timestamp format)

השעה שבה תהליך האישור הושלם.

השימוש הוא ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
dueTime

string (Timestamp format)

המועד לאישור הבקשה.

השימוש הוא ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
status

enum (Status)

סטטוס האישור בזמן שהמשאב הזה התבקש.
initiator

object (User)

המשתמש שביקש את האישור.
reviewerResponses[]

object (ReviewerResponse)

התגובות של הבודקים לאישור.
fileContentChangeBehavior

enum (FileContentChangeBehavior)

ההתנהגות של האישור כשתוכן הקובץ משתנה.

סטטוס

הסטטוסים האפשריים של אישור.

טיפוסים בני מנייה (enum)
STATUS_UNSPECIFIED סטטוס האישור לא הוגדר או שהוגדר לו ערך לא חוקי.
IN_PROGRESS תהליך האישור התחיל אבל עדיין לא הסתיים.
APPROVED תהליך האישור הסתיים והיעד אושר.
CANCELLED תהליך האישור בוטל לפני שהסתיים.
DECLINED תהליך האישור הסתיים והיעד נדחה.

ReviewerResponse

תגובה לאישור שבוצעה על ידי בודק ספציפי.

ייצוג ב-JSON 
{
  "kind": string,
  "reviewer": {
    object (User)
  },
  "response": enum (Response)
}
שדות
kind

string

הערך הזה הוא תמיד drive#reviewerResponse.
reviewer

object (User)

המשתמש שאחראי לתגובה הזו.
response

enum (Response)

תגובת הבודק לאישור.

תשובה

תגובות אפשריות לאישור.

טיפוסים בני מנייה (enum)
RESPONSE_UNSPECIFIED התגובה הוגדרה לערך לא מזוהה.
NO_RESPONSE הבודק לא הגיב.
APPROVED הבודק אישר את הפריט.
DECLINED הבודק דחה את הפריט.

FileContentChangeBehavior

ההתנהגות של האישור כשתוכן הקובץ משתנה בזמן שהאישור Status הוא IN_PROGRESS. ההתנהגות הזו לא מתרחשת יותר אחרי שהאישור הושלם.

טיפוסים בני מנייה (enum)
FILE_CONTENT_CHANGE_BEHAVIOR_UNSPECIFIED ההתנהגות לא מוגדרת.
RESET_APPROVAL כל ReviewerResponse עם Response של APPROVED יאופס ל-NO_DECISION כשתוכן הקובץ ישתנה בזמן שהאישור הוא Status של IN_PROGRESS. כשהאישור כולל Status של APPROVED ובוחרים באפשרות RESET_APPROVAL, הקובץ ננעל.
NO_APPROVAL_ACTION לא מתבצעת שום פעולה כשתוכן הקובץ משתנה.

Methods

approve

 מאשרת אישור.

cancel

 ביטול אישור.

comment

 תגובות על אישור.

decline

 דחיית אישור.

get

 אחזור אישור לפי מזהה.

list

 הצגת רשימת האישורים של קובץ.

reassign

 הקצאה מחדש של הבודקים באישור.

start

 התהליך מתחיל כשמישהו מבקש אישור בקובץ מסוים.