Corpus Permissions

तरीका: Corpara.permissions.create

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

एंडपॉइंट

पोस्ट https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*}/permissions

पाथ पैरामीटर

parent string

ज़रूरी है. Permission का पैरंट रिसॉर्स. फ़ॉर्मैट: tunedModels/{tunedModel} corpora/{corpus} इसका फ़ॉर्मैट corpora/{corpora} होता है.

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

अनुरोध के मुख्य भाग में Permission का उदाहरण है.

फ़ील्ड
granteeType enum (GranteeType)

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

emailAddress string

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

role enum (Role)

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

अनुरोध का उदाहरण

Python

model_info = genai.get_model("tunedModels/my-increment-model")
# ...

public_permission = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)

group_permission = model_info.permissions.create(
    role="READER",
    # Use "user" for an individual email address.
    grantee_type="group",
    email_address="genai-samples-test-group@googlegroups.com",
)
tuned_models.py

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

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

तरीका: corpora.permissions.list

यह डायलॉग बॉक्स किसी खास संसाधन के लिए अनुमतियों की जानकारी देता है.

एंडपॉइंट

पाएं https://generativelanguage.googleapis.com/v1beta/{parent=corpora/*}/permissions

पाथ पैरामीटर

parent string

ज़रूरी है. अनुमतियों का पैरंट रिसॉर्स. फ़ॉर्मैट: tunedModels/{tunedModel} corpora/{corpus} इसका फ़ॉर्मैट corpora/{corpora} होता है.

क्वेरी पैरामीटर

pageSize integer

ज़रूरी नहीं. दिए जाने वाले Permission सेकंड की ज़्यादा से ज़्यादा संख्या (हर पेज के हिसाब से). ऐसा हो सकता है कि यह सेवा, कम अनुमतियां दिखाए.

अगर इसे तय नहीं किया गया है, तो ज़्यादा से ज़्यादा 10 अनुमतियां वापस दी जाएंगी. यह तरीका हर पेज के लिए ज़्यादा से ज़्यादा 1,000 अनुमतियां दिखाता है, भले ही आपने बड़ा pageSize को पास किया हो.

pageToken string

ज़रूरी नहीं. पेज टोकन, जो पिछले permissions.list कॉल से मिला था.

अगला पेज वापस पाने के लिए, अगले अनुरोध के लिए तर्क के तौर पर, एक अनुरोध के बाद मिले pageToken को उपलब्ध कराएं.

पेजेशन करते समय, permissions.list को दिए गए सभी अन्य पैरामीटर, उस कॉल से मेल खाने चाहिए जिसने पेज टोकन दिया था.

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

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

अनुरोध का उदाहरण

Python

model_info = genai.get_model("tunedModels/my-increment-model")

# ...

for p in model_info.permissions.list():
    print(p)
tuned_models.py

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

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

तरीका: corpora.permissions.get

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

एंडपॉइंट

get https://generativelanguage.googleapis.com/v1beta/{name=corpora/*/permissions/*}

पाथ पैरामीटर

name string

ज़रूरी है. अनुमति का संसाधन नाम.

फ़ॉर्मैट: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} इसका फ़ॉर्मैट corpora/{corpora}/permissions/{permission} होता है.

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

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

अनुरोध का उदाहरण

Python

model_info = genai.get_model("tunedModels/my-increment-model")

# ...

public = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)
print(public)
name = public.name
print(name)  # tunedModels/{tunedModel}/permissions/{permission}

from_name = genai.types.Permissions.get(name)
print(from_name)
tuned_models.py

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

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

तरीका: corpora.permissions.patch

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

एंडपॉइंट

पैच https://generativelanguage.googleapis.com/v1beta/{permission.name=corpora/*/permissions/*}

PATCH https://generativelanguage.googleapis.com/v1beta/{permission.name=corpora/*/permissions/*}

पाथ पैरामीटर

permission.name string

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

क्वेरी पैरामीटर

updateMask string (FieldMask format)

ज़रूरी है. अपडेट किए जाने वाले फ़ील्ड की सूची. स्वीकार किए गए फ़ील्ड: - भूमिका (Permission.role फ़ील्ड)

यह फ़ील्ड के पूरी तरह से क्वालिफ़ाइड नामों की सूची है. इसमें नामों को कॉमा लगाकर अलग किया गया है. उदाहरण: "user.displayName,photo".

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

अनुरोध के मुख्य भाग में Permission का उदाहरण है.

फ़ील्ड
role enum (Role)

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

अनुरोध का उदाहरण

Python

        model_info = genai.get_model("tunedModels/my-increment-model")

        # ...

        test_group = model_info.permissions.create(
            role="writer",
            grantee_type="group",
            email_address="genai-samples-test-group@googlegroups.com",
        )

        test_group.update({"role": "READER"})

    def test_tuned_models_permission_delete(self):
        model_info = genai.get_model("tunedModels/my-increment-model")
        # ...

        public_permission = model_info.permissions.create(
            role="READER",
            grantee_type="EVERYONE",
        )

        public_permission.delete()


if __name__ == "__main__":
    absltest.main()

tuned_models.py

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

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

तरीका: corpora.permissions.delete

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

एंडपॉइंट

मिटाएं https://generativelanguage.googleapis.com/v1beta/{name=corpora/*/permissions/*}

पाथ पैरामीटर

name string

ज़रूरी है. अनुमति के संसाधन का नाम. फ़ॉर्मैट: tunedModels/{tunedModel}/permissions/{permission} corpora/{corpus}/permissions/{permission} इसका फ़ॉर्मैट corpora/{corpora}/permissions/{permission} होता है.

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

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

अनुरोध का उदाहरण

Python

model_info = genai.get_model("tunedModels/my-increment-model")
# ...

public_permission = model_info.permissions.create(
    role="READER",
    grantee_type="EVERYONE",
)

public_permission.delete()
tuned_models.py

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

अगर एपीआई सही से जुड़ जाता है, तो जवाब का मुख्य हिस्सा खाली होता है.

REST रिसॉर्स: corpora.permissions

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

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

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

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

  • पाठक, अनुमान लगाने के लिए संसाधन (जैसे कि ट्यून किया गया मॉडल, कॉर्पस) का इस्तेमाल कर सकता है
  • लेखक के पास लोगों की अनुमतियां होती हैं. इसके अलावा, वह लेखक के कॉन्टेंट में बदलाव और उसे शेयर भी कर सकता है
  • मालिक के पास लेखक की अनुमतियां होती हैं. साथ ही, वह फ़ाइल को मिटा सकता है
फ़ील्ड
name string

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

granteeType enum (GranteeType)

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

emailAddress string

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

role enum (Role)

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

JSON के काेड में दिखाना 
{
  "name": string,
  "granteeType": enum (GranteeType),
  "emailAddress": string,
  "role": enum (Role)
}

GranteeType

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

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

भूमिका

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

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

ListPermissionsResponse

ListPermissions से मिला जवाब, जिसमें पेज पर मौजूद अनुमतियों की सूची शामिल है.

फ़ील्ड
permissions[] object (Permission)

वापस ली गई अनुमतियां.

nextPageToken string

अगला पेज पाने के लिए, pageToken के तौर पर भेजा जा सकने वाला टोकन.

अगर इस फ़ील्ड को छोड़ा जाता है, तो इसका मतलब है कि कोई और पेज नहीं है.

JSON के काेड में दिखाना 
{
  "permissions": [
    {
      object (Permission)
    }
  ],
  "nextPageToken": string
}