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)

अनुमति का अनुरोध किए जाने का समय.

यह आरएफ़सी 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)

मंज़ूरी में पिछली बार बदलाव किए जाने का समय.

यह आरएफ़सी 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)

अनुमति देने की प्रोसेस पूरी होने का समय.

यह आरएफ़सी 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)

अनुमति मिलने का समय.

यह आरएफ़सी 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)

फ़ाइल के कॉन्टेंट में बदलाव होने पर, अनुमति की स्थिति में होने वाला बदलाव.

स्थिति

अनुमति की ये स्थितियां हो सकती हैं.

Enums
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)

अनुमति के लिए, समीक्षा करने वाले व्यक्ति का जवाब.

जवाब

अनुमति मिलने पर मिलने वाले संभावित जवाब.

Enums
RESPONSE_UNSPECIFIED जवाब को ऐसी वैल्यू पर सेट किया गया था जिसकी पहचान नहीं की जा सकी.
NO_RESPONSE समीक्षक ने जवाब नहीं दिया है.
APPROVED समीक्षक ने आइटम को मंज़ूरी दे दी है.
DECLINED समीक्षक ने आइटम को अस्वीकार कर दिया है.

FileContentChangeBehavior

अनुमति मिलने की प्रक्रिया के दौरान फ़ाइल के कॉन्टेंट में बदलाव होने पर, अनुमति मिलने की प्रक्रिया का व्यवहार. यह तब होता है, जब अनुमति मिलने की प्रक्रिया Status IN_PROGRESS. अनुमति मिलने के बाद, ऐसा नहीं होता.

Enums
FILE_CONTENT_CHANGE_BEHAVIOR_UNSPECIFIED व्यवहार के बारे में नहीं बताया गया है.
RESET_APPROVAL अगर अनुमति की Status IN_PROGRESS है और इस दौरान फ़ाइल के कॉन्टेंट में बदलाव किया जाता है, तो APPROVED Response वाले किसी भी ReviewerResponse को NO_DECISION पर रीसेट कर दिया जाएगा. जब अनुमति की स्थिति APPROVED में से Status हो और RESET_APPROVAL को चुना गया हो, तो फ़ाइल लॉक हो जाती है.
NO_APPROVAL_ACTION फ़ाइल के कॉन्टेंट में बदलाव होने पर कोई कार्रवाई नहीं की जाती.

तरीके

approve

अनुमति देता है.

cancel

अनुमति रद्द करता है.

comment

अनुमति के अनुरोध पर की गई टिप्पणियां.

decline

अनुमति अस्वीकार कर देता है.

get

आईडी के हिसाब से, मंज़ूरी की जानकारी फ़ेच करता है.

list

किसी फ़ाइल से जुड़ी अनुमतियों की सूची दिखाता है.

reassign

अनुमति देने के लिए, समीक्षकों को फिर से असाइन करता है.

start

किसी फ़ाइल के लिए, अनुमति पाने की प्रोसेस शुरू करता है.