REST Resource: approvals

منبع: تصویب

فراداده برای تأیید. تأیید، فرآیند بررسی یا تأیید یک مورد در درایو است.

نمایش 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 است.

approvalId

string

شناسه تایید.

targetFileId

string

شناسه فایل هدفِ تأیید.

createTime

string ( Timestamp format)

فقط خروجی. زمان ایجاد تأیید.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 فرآیند تأیید به پایان رسیده و هدف رد شده است.

پاسخ داور

پاسخی به تأییدیه صادر شده توسط یک داور خاص.

نمایش 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 داور، مورد را رد کرده است.

رفتار تغییر محتوای فایل

رفتار تاییدیه زمانی که محتوای فایل تغییر می‌کند در حالی که تاییدیه [وضعیت][] در وضعیت 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

 تأیید یک فایل را آغاز می‌کند.