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

ההתנהגות של האישור כשתוכן הקובץ משתנה בזמן שהאישור [סטטוס][] הוא 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

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