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-نرمال‌شده است و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «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-نرمال‌شده است و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «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-نرمال‌شده است و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «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-نرمال‌شده است و از ۰، ۳، ۶، یا ۹ رقم اعشاری استفاده می‌کند. انحراف‌های غیراز «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)

رفتار تأییدیه وقتی محتوای فایل تغییر می‌کند.

وضعیت

وضعیت‌های احتمالی تأیید.

شمارشی‌ها
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)

پاسخ مرورگر برای تأیید.

پاسخ

پاسخ‌های احتمالی برای تأیید.

شمارشی‌ها
RESPONSE_UNSPECIFIED پاسخ روی مقدار ناشناخته‌ای تنظیم شده است.
NO_RESPONSE مرورکننده پاسخ نداده است.
APPROVED مرورکننده مورد را تأیید کرده است.
DECLINED مرورگر مورد را رد کرده است.

FileContentChangeBehavior

رفتار تأییدیه وقتی محتوای فایل تغییر می‌کند درحالی‌که تأییدیه Status IN_PROGRESS است. وقتی تأیید کامل شود، این رفتار دیگر رخ نمی‌دهد.

شمارشی‌ها
FILE_CONTENT_CHANGE_BEHAVIOR_UNSPECIFIED رفتار نامشخص است.
RESET_APPROVAL هر ReviewerResponse با Response APPROVED، وقتی محتوای فایل تغییر کند و تأییدیه Status IN_PROGRESS داشته باشد، به NO_DECISION بازنشانی خواهد شد. وقتی تأییدیه دارای Status از APPROVED باشد و RESET_APPROVAL انتخاب شده باشد، فایل قفل می‌شود.
NO_APPROVAL_ACTION وقتی محتوای فایل تغییر می‌کند، هیچ اقدامی انجام نمی‌شود.

روش‌ها

approve

 تأییدی را تأیید می‌کند.

cancel

 تأیید را لغو می‌کند.

comment

 نظرات مربوط به تأیید.

decline

 تأییدی را رد می‌کند.

get

 تأییدیه‌ای با شناسه دریافت می‌کند.

list

 تأییدیه‌های فایل را فهرست می‌کند.

reassign

 مرورکنندگان را در تأییدیه دوباره واگذار می‌کند.

start

 تأییدی را برای فایلی شروع می‌کند.