Method: labels.revisions.permissions.batchUpdate

लेबल की अनुमतियां अपडेट करता है. अगर दिए गए प्रिंसिपल के लिए कोई अनुमति मौजूद नहीं है, तो एक नई लेबल अनुमति बनाई जाती है. अगर अनुमति मौजूद है, तो उसे अपडेट कर दिया जाता है. अनुमतियों से लेबल संसाधन पर पूरी तरह से असर पड़ता है. इनमें बदलाव नहीं किया जाता और इन्हें पब्लिश करने की ज़रूरत नहीं होती.

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

POST https://drivelabels.googleapis.com/v2/{parent=labels/*/revisions/*}/permissions:batchUpdate

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

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. पैरंट लेबल का वह संसाधन नाम जिसे अपडेट की जा रही सभी अनुमतियों के साथ शेयर किया गया है. फ़ॉर्मैट: labels/{label} अगर यह सेट है, तो UpdateLabelPermissionRequest मैसेज में पैरंट फ़ील्ड खाली होना चाहिए या इस फ़ील्ड से मैच करना चाहिए.

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

अनुरोध के मुख्य भाग में, नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "requests": [
    {
      object (UpdateLabelPermissionRequest)
    }
  ],
  "useAdminAccess": boolean
}
फ़ील्ड
requests[]

object (UpdateLabelPermissionRequest)

ज़रूरी है. अनुरोध का मैसेज, जिसमें अपडेट किए जाने वाले संसाधनों के बारे में बताया गया हो.
useAdminAccess

boolean

उपयोगकर्ता के एडमिन क्रेडेंशियल का इस्तेमाल करने के लिए, इसे true पर सेट करें. ऐक्सेस देने से पहले, सर्वर इस बात की पुष्टि करेगा कि उपयोगकर्ता, लेबल का एडमिन है या नहीं. अगर यह सेट है, तो UpdateLabelPermissionRequest मैसेज में useAdminAccess फ़ील्ड खाली होना चाहिए या इस फ़ील्ड से मेल खाना चाहिए.

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

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

अनुमति के दायरे

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

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.