REST Resource: corpora.permissions

संसाधन: अनुमति

अनुमति की मदद से, उपयोगकर्ता, ग्रुप या दुनिया के बाकी लोगों को PaLM API संसाधन का ऐक्सेस मिलता है. जैसे, ट्यून किया गया मॉडल, संग्रह.

रोल, अनुमति वाली कार्रवाइयों का एक कलेक्शन है. इसकी मदद से, उपयोगकर्ता PaLM API के संसाधनों पर खास कार्रवाइयां कर सकते हैं. उपयोगकर्ताओं, ग्रुप या सेवा खातों को उपलब्ध कराने के लिए, आपको भूमिकाएं असाइन करनी होती हैं. कोई भूमिका असाइन करते समय, उसमें शामिल अनुमतियां दी जाती हैं.

इसमें तीन खास भूमिकाएं होती हैं. हर भूमिका पिछली भूमिका के लिए मंज़ूर की गई कार्रवाइयों का सुपरसेट है:

  • पाठक, अनुमान के लिए रिसॉर्स का इस्तेमाल कर सकता है, जैसे कि ट्यून किया गया मॉडल, कॉर्पस
  • लेखक के पास पाठक की अनुमतियां होती हैं. साथ ही, वह लेखक के कॉन्टेंट में बदलाव और उसे शेयर कर सकता है
  • स्वामी के पास लेखक की अनुमतियां हैं और वे अतिरिक्त दस्तावेज़ भी हटा सकते हैं
जेएसओएन के काेड में दिखाना 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. आइडेंटिफ़ायर. अनुमति का नाम. बनाए जाने पर, एक यूनीक नाम जनरेट होगा. उदाहरण: TuneModels/{ TunedModel}/permissions/{permission} कॉर्पस/{corpus}/permissions/{permission} सिर्फ़ आउटपुट.
granteeType

enum (GranteeType)

ज़रूरी नहीं. इम्यूटेबल. अनुदान पाने वाले का टाइप.
emailAddress

string

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

enum (Role)

ज़रूरी है. इस अनुमति से मिली भूमिका.

GranteeType

यह बताता है कि यह अनुमति किस तरह की है.

Enums
GRANTEE_TYPE_UNSPECIFIED डिफ़ॉल्ट वैल्यू. इस वैल्यू का इस्तेमाल नहीं किया गया है.
USER यह उपयोगकर्ता का प्रतिनिधित्व करता है. सेट होने पर, आपको उपयोगकर्ता के लिए emailAddress देना होगा.
GROUP यह किसी ग्रुप का प्रतिनिधित्व करता है. सेट होने पर, आपको ग्रुप के लिए emailAddress देना होगा.
EVERYONE सभी लोगों का ऐक्सेस होता है. इसके लिए, किसी और जानकारी की ज़रूरत नहीं है.

Role

इस अनुमति से मिली भूमिका के बारे में बताता है.

Enums
ROLE_UNSPECIFIED डिफ़ॉल्ट वैल्यू. इस वैल्यू का इस्तेमाल नहीं किया गया है.
OWNER मालिक, संसाधन का इस्तेमाल कर सकता है, उसे अपडेट कर सकता है, शेयर कर सकता है, और मिटा सकता है.
WRITER लेखक, संसाधन को इस्तेमाल, अपडेट, और शेयर कर सकता है.
READER आपका कॉन्टेंट पढ़ने वाले लोग, इस संसाधन का इस्तेमाल कर सकते हैं.

तरीके

create

 किसी खास संसाधन के लिए अनुमति बनाएं.

delete

 अनुमति मिटा देता है.

get

 किसी खास अनुमति के बारे में जानकारी मिलती है.

list

 किसी खास संसाधन के लिए अनुमतियां दिखाता है.

patch

 अनुमति को अपडेट करता है.