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,
  "fileContentChangeBehavior": enum (FileContentChangeBehavior)
}
फ़ील्ड
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

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

enum (FileContentChangeBehavior)

ज़रूरी नहीं. फ़ाइल के कॉन्टेंट में बदलाव होने पर, मंज़ूरी की प्रोसेस का व्यवहार.

जवाब का मुख्य हिस्सा

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

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

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

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

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