Method: labels.permissions.batchUpdate

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

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

POST https://drivelabels.googleapis.com/v2/{parent=labels/*}/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

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