Method: approvals.start

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

एचटीटीपी अनुरोध

POST https://www.googleapis.com/drive/v3/files/{fileId}/approvals:start

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
fileId

string

ज़रूरी है. उस फ़ाइल का आईडी जिस पर अनुमति का अनुरोध किया जाएगा.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "reviewerEmails": [
    string
  ],
  "dueTime": string,
  "lockFile": boolean,
  "message": string
}
फ़ील्ड
reviewerEmails[]

string

ज़रूरी है. उन उपयोगकर्ताओं के ईमेल पते जिन्हें अनुमति देने से पहले समीक्षा करने के लिए सेट किया गया है.
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".
lockFile

boolean

ज़रूरी नहीं. मंज़ूरी की प्रोसेस शुरू करते समय, फ़ाइल को लॉक करना है या नहीं.
message

string

ज़रूरी नहीं. समीक्षकों को सूचना देने के लिए मैसेज. इस मैसेज में, उन्हें अनुमति के अनुरोध के बारे में बताया जाता है.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में Approval का एक इंस्टेंस शामिल किया जाता है.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata

कुछ स्कोप पर पाबंदी है. इसलिए, आपके ऐप्लिकेशन को इनका इस्तेमाल करने से पहले सुरक्षा का आकलन करना होगा. ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.