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

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