REST Resource: approvals

संसाधन: Approval

मंज़ूरी के लिए मेटाडेटा. अनुमति देने का मतलब है कि 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 अगर अनुमति मिलने की प्रोसेस के दौरान फ़ाइल के कॉन्टेंट में बदलाव होता है, तो जिन ReviewerResponse का Response 'अनुमति मिली' पर सेट है उन्हें 'कोई फ़ैसला नहीं लिया गया' पर रीसेट कर दिया जाएगा. ऐसा तब होगा, जब अनुमति मिलने की प्रोसेस का [Status][] IN_PROGRESS पर सेट हो. जब अनुमति का [Status][] APPROVED हो और RESET_APPROVAL चुना गया हो, तब फ़ाइल लॉक हो जाती है.
NO_APPROVAL_ACTION फ़ाइल के कॉन्टेंट में बदलाव होने पर, कोई कार्रवाई नहीं की जाती.

तरीके

approve

मंज़ूरी के अनुरोध को स्वीकार करता है.

cancel

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

comment

किसी अनुरोध को मंज़ूरी देने के बारे में टिप्पणियां.

decline

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

get

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

list

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

reassign

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

start

यह किसी फ़ाइल के लिए मंज़ूरी पाने का अनुरोध करता है.